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Preface 



The Apple* UGS™* personal computer is an Apple II with many 
advanced hardware features, new firmware features, and a software 
toolbox, similar lo Lhc toolbox in the Macintosh™ personal 
computer. To describe the many different aspects of the 
Apple tIGS F there are several technical books. Together, those 
books make up the Apple IIGS technical manual suite. 

As the first book m the suite, this book, the Technical introduction 
to the Appie IIGS, has several objectives. They are 

a to describe the features of the Apple lies 

□ to serve as a delta guide for purchasers of the Apple IIGS 
Upgrade for the Apple He 

□ to explain the general design of the Apple lies 

a to introduce hardware designers to the Apple TIGS 

a to describe the different program environments in the 
Apple IIGS 

G to introduce programmers to the Apple IIGS Toolbox 

□ to introduce developers to the Apple IIGS Programmer's 
Workshop 

The Apple Tics is an Apple El with a difference— or rather several 

differences. Those differences are particularly important to the 
person who purchases an Apple 11 gs Upgrade, which add* the 
features of the Apple IIGS to an Apple He. By providing technical 
information about the added features, the Technical Introduction 
serves as a delta guide for the upgraded Apple ITe, 



Tno d«khop environment Is a 
so" of p'ogram features that 
moke user interactions with an 
application resemble operations, 
on a desktop. The user selects 
opjects or commands by uslrvg 
the mouse to move o pointer on 
the screen. 



Where the Apple IIGS Owner's Guide describes the Apple IIGS from 
the point of view of the user, the Technical Introduction describes 
the Apple IIGS from the point of view of the application program. In 
other words, it describes the things the programmer has to consider 
while designing a program, such as the operating features the 
program uses and the environment in which the program nins. 

Like Gaul, the set of alt programmers starting out on the Apple IIGS 

is divided into three parts: 

p programmers who are familiar with one or more computers in 

the Apple fl family 
z programmers who are familiar with the Apple Macintosh 

□ programme rs who are not familiar with either line of Apple 
computers 

The Technical Intnxtuction addresses all three kinds of 
programmers. That means the book on.cn describes features of the 
Apple IIGS that arc also found on some other Apple machines and 
so are already familiar to same programmers. To make it easy to 

skip over such descriptions, they are labeled either as Apple II or 
Macintosh information 

Chapter 1 of the Technical Introduction starts by listing the features 
of the Apple IIGS, with emphasis on the new features thai make the 
Apple IIGS muni powerful than earlier models of the Apple 13. It 
also contains a Use of the features lhat provide compatibility with 
those earlier models and a List of die features that resemble those of 
the Macintosh. The latter part of Lhc chapter discusses aspects of die 
Apple ifGS thai will be or i merest to developers: the Apple IIGS 
Toolbox, the programming languages, the Apple [[GS 
Programmer's Workshop, and the technical manuals. 

The next three chapters describe the Features listed in Chapter 1, 
Chapter 2 describes the hardware, Chapter 3 describes the I/O 
features twhich involve both hardware and firmware}, and 
Chapter 4 describes lhc other firmware. 

Chapter 5 introduces an important new software feature of the 
Apple TIGS: the Toolbo*. which fe a set of built-in program tools, 
lhc Apple ncs Toolbox supports the desktop environment and 
makes it easier for application programs to take advantage of the 
new hardware features. 

Chapter 6 explains the design of the Apple fEGS, including a 
summary of the machine's architecture and a description of its 
memory features. 
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Chapter 7 describes the different program environments on the 
Apple lies, thai is, ihc different operating feaiui^.s anil ilitj way ihcy 
are used by different Types of programs. 

Chapter 8 describes other programming issues such as program 
compatibility with earlier models in the Apple IT family, 

Chapier 9 introduces software developers to the Apple 11GS 
Programmer's Workshop WW), which is a complete development 
system including an editor, a compiler, and a linker. 

The glossary lists technical terms used in this book. Some of the 
terms are also defined in marginal glosses near where they first 
appear in the lexL 

There are two appendixes, Appendix A, "Roadmap to the 
Apple IIGS Technical Manuals, * tells abuul the other technical 

manuals and helps you decide which ones you need Appendix L5, 
"Summary of Program Environments," is a summary of 
information from Chapter 7, "Program Environments." 



Notation and conventions 

This manual has a few special ways of indicating a term or a ptecc of 
information Lhat is: different En some way. 



Technical terms 

Th<; firei time a specialized term appears in this manual it is printed 
in boldface. All such terms are defined m the glossary at the back of 
the book. Some of them arc also defined in marginal glosses, as 
shown in the next section 

Here are some names, that an; used in a specific way to distinguish 
among the different members of she Apple II Family: 

■ Apple lit Anv of several computers in the Apple It family, which 
is made up of the Apple II. the Apple II Plus, the Apple Me, the 
Apple lie, and the Apple IlCS. 

■ Standard Apple Ik Any computer in the Apple II family except 
ihe Apple I1CS 

■ 8-blt Apple DT; Another way of saying standard Apple II. All 

those computers have 8-bit microprocessors. 
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■ 64 K Apple II: Any standard Apple II that has at least 64K of 
RAM. That includes the Appte Ik, the Apple He, and an Apple tl 
or Apple tt Plus with 48'K of RAM and the Apple Language Card 
installed. 

■ 128K Apple EI: Any standard Apple II with both main and 
auxiliary 64K banks of RAM. That includes all models of the 
Apple He and some models of the Apple lie, including those with 
the Extended SO-CoLumn Text Card installed. 

The letter K is the abbreviation for ktto-, meaning thousand. In this 
book h K stands for kilobyte {1G24 bytes]) except when dealing with 
memory ICs, when it stands for kilobit— 1024 bits. 



A marginal glau contains earner 
a definition of a term appearing 
In boldface in the text or a 
cj Disaster en ee eiiner Id 
anothor pan of thia book or lo 
anotner Ooo*. 



Important 



Sp&ctal messages 

Certain types of information ate set off in special ways in this book. 
This Is done in three ways; marginal glosses, notes, and important 
items, 

<► A'o/£- A note like this usually contains information that is 
interesting but not necessary for an understanding of the main 
text. Notes have labels such as Note or Reminder. Notes lhat 
provide background information about the Apple II or 
Macintosh Family are labeled Appte //or Macintosh. 



An item Ifcke this— wllh Important In the margin— contains 
Information that could ksep you from causing the computer or 
Its software to malfunction. 
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Chapter 1 

Introduction 

to the Apple Hgs 



The Apple ncs personal computer is a high-powered addition to 

the Apple E family. Like Janus, the god of doorways, the Apple tlGS 
looks in two directions. First, it looks toward the failure: with its 
many htgh -perform a nee features, such as Improved color display, 
advanced sound system, 1 6-bit microprocessor, and larger 
memory, the Apple IIGS makes it possible for future application 
programs to be more powerful, Second, the Apple IIGS looks 
toward the past: because it has the features of the Apple fTe and the 
Apple He, it can run most of the programs written for those 
computers. 



The features of the Apple I Eos 

J lhc Apple IIGS has mure Features than any earlier Apple TL So that 
you can get an overall idea of what die Apple lies is, this section 
lists its features, 

* Note.- The tables that follow aie only summaries ; to learn more 
about individual features, please keep reading. Chapters 2, 3, 
and 4 describe the hardware features, I/O features, and 
firmware features, respectively. 



A moid powerful Apple II 

The easiest way to describe the Apple lies is to list all its features, in 

addition to the features of the Apple He and the Apple lie, the 
Apple IIGS has many new features that set it apart from other models 
of the Apple IE, Tabic 1-1 describes all the major features, both old 

and new, 

* Atote Terms thai appear in boldface are defined in the 

glossary. 
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Toble 1-1 

Features of the Apple lies 


Ftalur* 


SpvclflesKon 


Description 


Mom powerful 

microprocessor 


65CS16 


l6^bit microprocessor has 24-bit microprocessor 

and 6-502 compatibility. 


Fabler opera [ion 


CPU dock speeds of 
1 MHz and 2.S Mite 


User can select either of two speeds: Lhe standard 
1 MHz speed of the Apple ll h or fast 2.8 MHz 

speed. 


Larger memory 


256K RAM, 128 K ROM 


Built-in memory includes the features of a I2SK 

Apple II. 


Memory expansion 


24*bit address bus and 
memory expansion slot 


Expansion card can expand RAM to as much as 
8.25 megabytes. 


Detached keyboard 


78 keys 


Separate keyboard includes cursor keys and 
numeric keypad. 


Apple DeskTop Bus™ 
interface 


Low-cost serial t/O 


Supports detached keyboard, mouse, and 
additional I/O devices. 


RGB video 


K. G, B, and sync 


Provides both analog RGB and NTSC video 

outputs. 


40- and 80-column 
text in color 


Text< background, and 
border colors 


Text, background, and border can be any of 16 
colors ConEy with HGB). 


Apple li graphics 


Lo-Res, HI Res, and 
Double Hi- Res 


Standard Apple II graphics, including Double 
Hi- He* as on 12BK models, 


Super Hi-Res color 

graphics 


True 320 x 200 or 6m x 200 

resolution 


Improved graphics with up tr> 16 colors per scan 
line and up to 256 colors on screen, out of ^096 

possible colors. 


Desktop user 
interface 


Uses Super He-Hcs 
color graphics and 
mouse 


Built-in Toolbox supports desktop interface with 
mouse,, menus, and windows. 


improved sound 


Ensoniq digital sound IC 
with 32 oscillators 


Digital sampling synthesizer supports 15 
Independent voices. CApplc IIGS also retains 
single-bit sound used in other Apple lis, add^ 
volume control.) 


Control panel 


Built-in desk accessory 


User can set machine parameters for display h 
operating speed, serial ports, and disk drives. 
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To bis 1-1 (continued) 

Features of the Apple lies 




Ftatur* 


Specification Oeicripliori 


Enhanced Monitor 


Monitor in POM Handles lfi-bit and 24-bit addresses, assembles 
and disassembles G5816 and fi^OZ Instructions, 

performs 32-bit arithmetic- includes low-level 
I/O routines for display and keyboard. 


Applesoft 


Applesoft in ROM Applesoft with modifications for lowercase and 
SO^cotumn operation 




Built-in clock 


Time and date Clock has battery for continuous operation. 




Built-in serial ports 


:vrn Milliard atrial ports Sc:iil pens support modems, printers, and 
AppleTalk (User can still use serial card in 
slot.) 




Built-in AppleTalk* 


Uses one serial port No peripheral card required. User can select 

either serial I/O port to use Fur AppleTalk. 




Built-in disk port 


Disk L/Q port using User can select built-in disk port, disk interface 
custom IG cards in slots, or both, for as many as six drives 

at one lime. 


Expansion slots 


Seven slots for Expansion slots like those on Apple He. 
peripheral cards (Apple UGS does not have auxiliary slot.) 


Game I/O 


External 9-pin jack, Supports all existing game hardware. (Some new 
internal l6-pln socket devices use Apple DeskTop Bus Instead.) 






Apple II compatibility 






Even though the Apple IIGS has many powerful new features, it is 
important to remember that it is an Apple U. That means that most 
existing programs and peripheral devices as well as future programs 
developed for the Apple lie and Apple lie will run on the 
Apple IIGS. 






The Apple IIGS has several features that make it compatible with 
earlier models of the Apple II. Table 1-2 is a list of those features, 

along with the other models of Apple II that also have them 
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Table 1 -2 

Apple Ji features or ftie Apple lies 


Apple IIGS feature 


Description 


Diner model* 


6502 instruction set 


65CSI6 has emulation mode for running 6502 

programs 


All Apple lis 


I28K RAM 


Main and auxiliary 64K banks, with language- 
card and I/O spaces 


Apple lie, 128K ITe 


Applesoft in ROM 


Applesoft BASIC interpreter with lowercase and 
80-COlumn features 


All Apple Jl's 


Ntonitor in ROM 


Supports low- level I/O and program 
development 


All Apple n's 


40- and 80-coiumn text 


Black-and-white text displays (text in color only 
when used with RGB monitor) 


Apple Be, Be with 128K 

Or 80-ealumn card 


La-Res color graphics 


4B x 40. 16 colors 


All Apple Il h s 


Hi-He* color graphics 


280 x 192, 6 colors 


All Apple I Is 


Double Hi-ftCS color 
graphics 


5&Q x 192, 16 colors 


Apple lie, 128K He 


Built-in serial ports 


Two RS-232-c-Ompatible ports, for modem, 
printer, oLher serial devices 


Apple lie (similar) 


Built-in disk port 


Lising IWM chip, supports both 5.25-inch and 
3. 5 -inch disk drives 


Apple He 


Expansion slots (7) 


Slots for peripheral I/O and expansion cards, in 

addition to built-in ports 


Apple 13 h tl Plus, He 


Game I/O port 


9-pin and l6"-pin connectors for game paddles 
and sketch pads 


Apple lie, Me 




Similarities to ths Macintosh 






Comparison of the hardware features of the Apple IIGS and the 
Macintosh will reveal more differences than similarities. Among 
the differences are 




z 'l"he Apple IIgs has a 65GB 16 microprocessor, while the 

Macintosh has a 6SO0O. 




a The Apple IIGS has a color display, the Macintosh is black-and- 
white. 




□ The Apple IIGS has slots, the Macintosh hasn't 
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In applications that use the 
desktop user internee, 
commands appear aa opflona In 
pulldown menu*, end material 
being worked on appears in 
areas at the screen car»ed 
windows. Tne user select* 
commands o* asher marerlol by 
using the mouse to move a 
pointer around on the screen. 



On the other hand, while the two machines' operating systems are 
different, they both support hierarchical disk directories. And 
some of the hardware features are the same, such as the detached 

keyboard and the mouse. 

While the Apple TIC-S itself doesn't work like the Macintosh, 
applications on the Apple IIGS will bear a strong resemblance to 
Macintosh applications. The main reason is the use of the same 
desktop user interface on both machines. The built-in 
Apple 11CS Toolbox, like the Macintosh Toolbox, makes it easy for 
applications to support the desktop interface. Table 1-3 summarizes 
ilic major points of similarity, as well as some of the differences, 
between the two machines. The resemblances are described further 
in Chapter 5, "The Apple ILGS Toolbox." 



Tohl*l-3 

The Apple IIgs compared with the Macintosh 



Feature 



Apple tios version 



Macintosh vefilon 



Desktop user 
interface 

Desktop support 

for applications 

Desktop display 

Display resolution 
Command selection 
Keyboard 

Built-in serial pons 

Built-in tSivk jn:rt 

Operating system 

Externa I hard disk 



Pull-down menus; data in 
overlapping windows 

Built-in toolbox 

Super Hi-Res color graphics 

640x200 

AppleMause™, keyboard optional 

Detached, with keypad and cursor 
keys 

Two ports, usiriy [he Zilisg SCC chip 

and RS-422 drivers 

5-25-inch and 3. 5-inch drives, using 
the Apple IWM chip 

Pro DOS™ (hierarchical fitesD 

Hard Disk Z05C with SCSI interface 
card 



E'lill-drjwn menus; data in 
overlapping; windows 

Built-in toolbox 

Bit-mapped black-and-white 
graphics 

512x342 

AppleMousCp keyboard optional 

iJctachcd, with keypad and cursor 
keys on Macintosh Plus 

Two RS-232 ports, using the Zilog 
SCC chip 

3-5-inch drives only 

Hierarchical file system 

Hard Disk 20 {Hard Disk 20SC on 
Macintosh Plus) 
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For program developers 

The Apple IIGS has several features that are important for 
developer. First of all r there la the Apple IIGS Toolbox, a 
collection of built-in program routines that can be called by 
applications. Then (here is the program development 
environment, the Apple IIGS Programmer's Workshop (APW)> 
which includes the language compilers and their environment. 
With the built-in toolbox, the language compilers, the workshop 
programs, and (he technical manuals I hat describe tine en, 
developers have everything they need to develop applications for 
the Apple JfGS. 



The Apple IIGS Toolbox 

like the Macintosh, the Apple IIGS has a built-in toolbox whose 
routines can be called by applications. The toolbox routines 
include mouse operations with menus and windows to support the 
desktop user interface. 

N T ox all of the tools ait resident in ROM: some of ihem are loaded 
from disk and reside in RAM. The calling mechanism is the same 
regardless of where in memory a tool resides, A tool can even be in 
ROM in an eariy version of the system and in RAM in a later 
version; an application developed on the early version will run on 
the later version wiLhnut modification. 

The Appte IIGS Toolbox includes many functions like the ones in 
the Macintosh Toolbox, but they are not all the same. There are 
important differences between the machines, and those differences 
affect The nature and operation of the tools. 

For a summary of the Apple JIGS Toolbox and more about ihc 
differences between the tools in the Apple IIGS and the Macintosh, 

please read Chapter 5, 'The Apple IIGS Toolbox. " For a complete 
description of the toolbox, see the Appic IIG$ Toolbox Reference, 
Volumes 1 and 2. 
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The Apple IIgs Programmer's Workshop 

To provide a consistent working environment, Ihere is the 
Apple dCS Programmers Workshop (APW). The development 
environment consists of two kinds of programs: the compiler and 
assembler, which have their own reference manuals, and the 
workshop programs, which are all described in the Apple IIGS 
Programmer's Workshop Reference. 

The Apple 11 GS Programmer's Workshop is a set of programs that 
Apple provides to make it easier lo develop applications for the 
Apple tics. The programs in the programmer's workshop are 

□ shell 
d editor 
u linker 

D debugger 

□ utilities 

For more information about APW. please see Chapter 9 r 
"Apple IIGS Development Environment," and the manual 
Apple IIGS f^rogrammer's Workshop Reference. 



Apple LI GS programming languages 

The languages available on I he Apple IICS include 658 1 6 assembly 
language and C. Thanks to the standard object-file format on the 
Apple nc.5, the same linker and loader can handle program 
segments created in either of the available programming languages. 
Because the languages are available separately, there is a separate 
manual for each one. 

The high-level language in APW is C. Programs written in C can 
easily include sections written in assembly language and in Pascal. 
APW C comes with a standard C library and an Apple JIGS Interface 

library, which contains the tool calls. 

The APW Assembler is a Full-featured macro assembler that 
supports the full 65C616 instniction set. (While the 65C816 
instructions include those for the 6502 and the 65C02, the assembler 

is not an appropriate development tool for Apple Il's that use those 
microprocessors because APW does not support Apple II binary- 
load files.) 

<r .Vole The Apple IIGS has standard Applesoft BASIC In ROM for 

compatibility with 01 her Apple Il's. 
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Apple I fGS technical manuals 

Tg fully describe ihe Apple IIGS, Apple has produced a suite of 

technical manuals. There are manuals that describe the Apple i!GS 
computer itself and other manuals thai describe the development 
Tools. Tabte \-4 lists the manuals by category. Depending on ihe 
way you intend tn use the Apple IIGS, you may need to refer to only 
a few oF the manuals, or you may need to refer lo most of them. 



Tabl» 1 -4 

Aople lies technlcol manuals 



Category 



Introductory manuals 

Mac-time reference manuals 

Toolbox manuals 
Workshop manual 
Hmgramming-language manuals 

Operating-system manuals 

All Apple manuals 



Title 



Technical Introduction to the Apple lias 
Programmer's introduction to the Apple IIGS 

Apple lias Hardware Reference 
Apple lias firmware Reference 

Apple IIGS Toolbox Reference, Volumes 1 and 2 

Apple lies Programmers Workshop Reference 

Apple IIGS Programmer's Workshop C Reference 

Apple lias Programmer's Workshop Assembler Reference 

ProDQS 8 Reference 

Apple IIGS PrvDQS 16 Reference 

Human Interface Guidelines 
Apple Numerics Manual 
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This chapter and ihe fol towing two chapters describe the features of 
the Appte IIGS, with emphasis on the new features This chapter 
covers the hardware features, Chapter 3 covers the I/O features, 
which combine elements of hardware and firmware, and Chapter 4 
covers the rest of the firmware features;. 






Apple 1IGS technology 




Far detailed descriptions at the 
iCi In the Apple AGS. consUt the 
rtppte IKS Harctoarv Jteferwiee. 


Trie Apple HGS is the mast advanced Apple II to date. It uses several 
large-scale integrated circuits that are custom designed for it. These 
ICs are surface mounted on a four-layer printed circuit board 
miiiiniud in the bottom of the case, By using large-scale custom ICs, 
the designers of the Apple lies were able to increase the. machine's 
capabilities wjih a mini mum increase in manufacturing cost. 

Tabic 2-1 lists the large ICs in the Appte tics, including the custom 
ICs. Some of those ICs are mentioned later in this chapter. 




Table 2-1 

Large-scats ICs in the Apple Hgs 






Nam* 


Function 


Megan 


Provides the basic Apple It addressing and timing 


Slotmaker 


Provides additional address and control signals for the expansion 
slots 




Fast Processor Interface (FPD 


Provides addressing and liming for fast memory; handles 
synchronization of processor and Mega II 




Video Graphics Controller 
(VGC) 


Provides video addressing and signal generation for Super Hi -Res 
display 




Integrated Wo* Machine (IWM} 


Controller for 5.25-inch and 3. 5-inch dLSk drives 




Sound General Logic Unit 
(Sound GLLJ) 


Provides interface between the system bus and the Digital Oscillator 

Chip CDOO 




Digital Oscillator Chip CDOC) 


Digital sampling Sound generator Grade by nnsonlq) 




Keyboard General Logic Unit 
(Key GUD 


Provides interface between the system bus and the keyboard 
microprocessor 




Keyboard Microprocessor 
(W740A) 


Supports the Apple DeskTop Bus (interface to the detached 
keyboard, the mouse h and similar devices) 
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Microprocessor features 

The microprocessor in the Appte IfCS us a 65C8t6 operating in 
conjunction with the custom FPI CPast Processor Interface) chip, 
The 65C&16 is a 16-bit CMOS design based on the venerable 6502, 
Table 2-2 lists its main features, 

Table 2-2 

Features of me 65 G616 microprocessor 

16 -bit accumulaiur 

iG-bit X and Y index registers 

Relocatable direct page 

Relocatable stack 

24-bit interna i address bus 

6-bit data address bank register 

8-bit program address bank register 

I 1 new addressing modes 

36 new Instructions, Tor a total of 91 Call 256 operation codes) 

Fast block-move instructions 

Ability to emulate: 6502 and 65O02 B-bit microprocessors 



Sixteen-bit processor 

In the Apple lies, the 65CBI6 normally operates hi eiiber of two 
modes; 6502 emulation mode and 65CS16 native mode. Figure 2-1 
snows the sizes of the register in emulation mode and in native 
mode. In emulation mode r the accumulator and index registers are 
eight bits wide, and existing Apple It programs run the same as they 
do on any other Apple II model. Tn native mode, the accumulator 
and index registers are sixteen bits wide, The 6^C8l6 also has 
several new and more powerful addressing modes that take 
advantage of Its 24-bit addressing. The new addressing modes 
operate in cither naiive mode or emulation mode, although the 
shorter registers tn emulation mode make some of them inelTective. 

* Nate. Native mode can also work with 8-bit data registers, with 
an additional accumulator, the B register. Apple docs not 
recommend 8-bit native mode, but some internal routines use 
il f and developers are free to use it if ilicy choose. 
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In Figure 2-1, the boxes represent registers, and the sizes of the 
boxes correspond to the number of bits in the registers, as 
indicated by the scales at the bottom of the figure. Letters in the 
boxes are the names of the registers; numbers (00, 01) in boxes 
indicate fixed values for those parts of the associated registers. For 
example, the stack pointer in native mode behaves like a 24-bit 
register with the upper eight bits permanently set to 0. 



diQ2 Emulorion mode 



65CSid Na^s moae 



I I I 

24 16 a 

Reenter length In totta 

Figure 2-1 

65CB16 registers 





B 


A 










00 


X 








DO 


V 








DBR 





00 


01 


S 





P 








1 


PC 






PBR 










DO 


D 



Accumulate* 

X lr*dex register 

V index register 

Data bank register 

Stac*. pointer 

Program statu* 

Program counter 

Proarom bank register 

Direct reg-ttor 



1 


A 






1 


K 








V 






□BR 







DO 





PC 






P0R 










00 


D 



f 1 — i 

7A 16 S 

Rng fer length In bits 



Two operating speeds 

The Apple HG& normally runs its 65C&16 microprocessor at a dock 
rate of 2.8 MHz. For programs in RAM, the effective speed is about 
2.5 MHz because trie hardware allocates a few dock cydes for 

refreshing the RAM and cannot execute RAM instructions during the 
refresh cycles. Programs in ROM are not affected by RAM refresh, 
so they run at the full 2.S MHz. 
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Almost all programs can run at the 2.5 MHz speed on lhc 

Apple ECS, even programs originally written for an 6-bit Apple II. 

The Apple IIgs can also run at ihe normal AppEe II clock rate. 

1 MHfc. There, are three conditions that can cause the Apple lies to 

run at the t MHz speed: 

□ The user has selected normal speed on the Control Panel. 

a A program is executing an instruction that uses ] MHz memory 
(see the section "Memory on the Appte [|CS H In Chapter 6 for a 
description of I Mil/ memory). 

□ A timing-dependent routine is executing; for example, one in a 
disk interface card. 



Memory features 

Thanks to the 24 -bit addressing of the 65CBIG, the Apple TIGS has a 
memory space totaling 16 megabytes. Of this total, up to B 
megabytes of memory are available for RAM expansion, and one 
megabyte is available for ROM expansion, Figure 2*2 Is a simplified 
version of the Apple IIgs memory map. 

Ihc internal memory uf the Apple UG5 has two main features- it can 
emulate the main and auxiliary memory 1 banks of a 12SK Apple II, 
and it can be expanded up to as much as 3.25 megabytes. The next 
two sections describe these features. 
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System, 
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SFD SFE SFF 




FhmwOr& 



•• - —RAM ■ 

Flgur* 2-2 

Simplified Apple Ngs memory map 
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Apple It main and auxiliary memory 

♦ Apple H: Ihis section describes the way memory Ls used in all 
models, including the Apple He and lie. If you arc already 
familiar with those machines, you might want to skip ahead to 
the next section. 

The 6502 microprocessor used in the original Apple II can address 
up to 64K bytes of memory. The Apple lie and the 12&K versions or 
the Appte He have 126K of memory, which they address in two 6AK 
banks. To distinguish ihe two banks, the original 64K of memory is 
referred to as main memory and ihe additional 64 K as auxiliary 
memory, In the Apple II G5, banks $00 and SOI work like main and 
auxiliary memory when running programs written for the Apple He 
and Apple lie. 

In the original Apple 11 and the Apple II Plus, different pans of the 
64K memory space are allocated Tor different purposes. Built-in 
ROM occupies the highest addresses, from SDOOO to SPFFF. 
Addresses between SC0O0 and 5CFFF are allocated to built-in I/O 
and to the peripheral slots for I/O devices and ROM on peripheral 
cards. Applications use memory in the 46K of space below SC0OO, 
except for the video display buffers, which are called pages. There 
are two text display pages and two Mi-Res graphics pages, Table 2-3 
shows their locations. 



Toble 2 3 

Standard Apple 11 display pages 



Display peg* 



Merrcy location* 



Texj Page 1 
Text Page 2 
Hi- Res Page \ 
Hi-Rcs Page 2 



S0400-5O7FF 
$0BOD-$0BFF 
$2000-1 31" PI- 
S4GOO-S5FFF 



16 



Chapter 2i Hardware Fea?ure& 



h 

n . 



The Potter x In gn ook>es standi 
for the ron$e of all posses 
values Tqj that digit For 
example. SO^nt means oil ihe 
addresses ftam 5DDGG through 
SDfFF. 
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When Apple introduced UCSD Pascal for the Apple IT P the "Tower 
forty-eight" kilobytes of memory was insufficient, so Apple added 
an expansion card with 16K of RAM The RAM expansion card was 

part or the Pascal language package ft>f the Apple [I, ftt> it was called 
the Apple Language Card.. To make 1GK of HAM addressable without 
disturbing the memory-mapped I/O in the SCxxx space, Apple 
designed the card with two 4 K banks at SDxxx, in the Apple He and 
the Apple lie. the entire 64K of main RAM is Installed on the main 
circuit board, hat the peculiar addressing of the upper banks Is 
retained for the sake of compatibility; Apple still refers to RAM 
memory between SDOOO and SFFFF that has two banks in the SDxkx 
space as language-card memory, even when it is on the main 
board, 

The technique for addressing the auxiliary 64K memory space also 
involves switching banks, but is independent of the language-card 
bank switching, in fact, the auxiliary memory has its own langu age- 
card space, compEete with two banks at $Dxxx fine I/O space, 
SCxsx, is the same in both main and auxiliary memory,) 

Figure 2-3 is the memory map for an Apple lie or a 12&K AppJe lie, 
showing the two 64K memory banks and the language-card banks 

above SC0O0, 



Mon 64K 




SFFFF 
ICCOO 

$6000 
$4010 

S000D 



AuXlKqrv O^K 




[; ::;.;;,; 1=1 j LOfirjuans' card 

figure 2-3 

123K Appld II memory mop 



User 



Memory fsciruf&s 



Display 
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Memory expansion 

The minimum memory in the Apple IIGS is 256K, Apple II 
programs use 12J3K of that, mapped as- main and auxiEsary memory; 
the system firmware uses pans of the other 12BK. Programs written 
for the Apple IIGS— that is, programs that run the 65C816 
microprocessor in native mode, thereby gaining the ability to 
address mote than T28K of memory— can use up to about 176K of 
the 256" K. The rest is reserved for displays and for use by the system 
firmware. 

"Die Appte IIGS also has a special card slot dedicated to memory 
expansion. All the RAM on a memory expansion card is available 
for Apple lies application programs that call the Memory 
Manager. Expansion memory is contiguous; its address space 
extends without a break through all the RAM on the card. Unlike the 
Apple lie, expansion RAM on the Apple lies Is not limited to use as 
a RA.M disk^ program code can run in any part of RAM. 

& jVdfc? The memory expansion sEot on [he Appte litis is not like 
cither the expansion slots or the auxiliary slot on the AppJe Lie. 
Memory expansion cards designed to run in either of those 
slots will not work in the Apple IIGS memory expansion sIoL (A 
memory expansion card designed to run in an Apple II 
expansion slot will run In one of the general-purpose expansion 
slots in the Apple IIGS, however.) 

Memory expansion cards for the Apple BGS can be several different 
sizes. Using presently available 25&K (kilobit) HAM chips, a 
memory expansion card can have up to a megabyte of additional 
RAM, When one -megabit RAM chips become available in quantity, 
a memory expansion card can have up to four megabytes of RAM. 
Ohe Apple IIGS will accept expansion RAM up to eight megabytes.) 
The additional RAM maps into contiguous 64K banks starting with 
bank $02, as- shown earlier in Figure 2-2. 

In addition to expansion RAM, the memory expansion cards can 
also have up to a megabyte of ROM. The additional ROM occupies 
memory from bank SFD downward to bank $F0. Portions of the top 
two banks of expansion ROM are allocated for system firmware 
expansion. The remaining expansion ROM is supported as KOM 
disk — permanent storage for applications,, w-hich the system 
handles like dish files. For additional information about memory, 
see Chapter 6. 



IB 



Chapter 2: Hardware Features 






RGfl : in noOf*?vloriCn r r" n&o^ 
green-drus. □ way o* nisplnymg 
colour viaeo by transmitting the 
three prim pry colors as tnreo 
se-pnrato signal*. With TTL RGB, 
only o few colon ore possible; 
w;M analog RG&, tr-e color 
Canals can take on any values 
betweon molr upoer ond lower 
llmhi. for a wide range of colors 

NTSC is the abbreviation for 
Woflanof Tolovtsian Standards 
CommiftsG and refers to a 
method Tar transrnining color 
video information for heme 
television rece-lv&rs ThaF 
method Is also called compostfe 
because It combines all the 
video Information, including 
color. Into a single signal. 



Display features 

To start with, the Apple IIG5 has the standard Apple U video modes, 
both graphics and text, and the text display is enhanced with a 
choice of colors for borders, text, and background. In addition, ihc 
Apple I1CS has built-in RGB video and two new Super Hi-Res 
graphics modes. 



RGB and composite video 

lilt Apple 31GS has both RGB and composite (NTSC) video 
outputs. Either type of video monitor csn be used with the 
Apple IlCS, ah hough an RGB monitor is required for BQ-column 
text in color. 

♦ :\ote: A monochrome monitor will work on the Apple ITG5. Alt 
the user has to do is connect it to [he composite video output 
jack and use the control panel to set the display type to 
monochrome. 

The RGB video Tram I lie Apple IIOS is amUugKGB. With an 
appropriate RGB monilor, the Super Hi-Res mode can display 
sharp graphics with any of 409& colors. For the sake of compatibility 
with programs that generate graphics for composite monitors, the 
Hi-Res and Double Hi- Res displays on the Apple IIGS look like 
composite video even on an RGB monitor 

* Historical note- At one time, Apple provided an RGB adaptor 

card and an RGB monitor, the AppIeColor* - 100 monitor, for 
the Apple II, Using thai system, Hi- Res and Double Hi -Res 
color displays were restricted to a horizontal resolution of only 
MO, a restriction that docs not apply to the Apple IlCS, Note 
that an AppteCoLor 100 Monitor requires separate digital 
signals., so it will not work on the Apple IIcjs. 
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Text with color 

The standard video modes on the Apple lies include three 
enhancements: colored texr, colored background, and colored 
border. For displaying <fO-cotu.mil or EG-column text on an RGB 
monitor, ihc user can select any of sixteen standard colors for text 
and any other of the sixteen colors for background. O ne Control 
Panel won't let the user set the text and background colors the 
same.) Any of the sixteen colors can be used for the border, that ts h 
the visible part of the display ouLsidc Lhe area used for k:xi .in.: 3 
graphics. 

♦ Note: Colored text works only with an RGB monitor, The 

composite video output automatically Switches to monochrome 
for lext displays, making the text, background, and border 
colors appear as black, white, or shades of gray. This feature 
reduces color fringing and improves the legibility of texl 
displayed on composite color monitors. 

+ By the way:The unused border around the video display is 
wide enough Lhat information on the edge of the display won't 
be lost when viewed on video monitors with their picture size 
controls set loo big. 



Apple II graphics 

■^ Apple //This section describes graphics features found im 
many other models of the Apple 11. If you are already familiar 
with the Apple II, you might want to skip ahead to the section 

"Super HUHcs Graphics." 

The Apple IICS includes the same graphics displays found on the 
Apple lie and 12BK AppEc Lie; Lo-Rcs, Hi -Res, Double Lo-Rcs, and 
Double Hi-Res. Table 1A shows the specifications for these 
displays. 
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Apple II graphics displays 






Display mod» 


R&solufion 


Numbar 

o1 colon 


Reslrlcilani 


Lo-Res 


40 >: 4B 


Ifi 


(one) 


Ni-fe 


280x192 


6 


Some colors cannot 
appear side-by -side 
in small aicas of Lhc 

display. 


Double Lo-Res* 


80x48 


Lii 


(none) 


Double Ili-Res* 


560x192 


11, 


(none) 



"\al supported by firmware. 

Like all other Apple H's, the Apple C1G& displays Lo-Res and Hi-Res 
color graphics. Applesoft. BASIC, in ROM, includes simple routines 
for setting colors and drawing dots and lines. The Apple 1IGS also 
has the double graphics modes, but, like other Apple Il's, it doesn't 
have graphics firmware for those modes. 

* tWote; For [he standard graphics modes — Lo-Res, Hi -Res. and 
Double fli-Res— the Apple Et uses a simple trick to generate 
color on a composite monitor. The individual dots in the 
graphics are spaced fust right to stimulate Lhe circuits that the 
monitor uses to extract color information from a composite 
signal. On Lo-Kes, [he large dots in [he display are made up of 
smaller dots that blend together on ihe screen.) Different 
combinations of do is make different colors. 



Super HI-Res graphics 

In addition to the standard video modes found nn she Apple He and 
Apple Sic, the Apple UGS also has two new Super Hi-Res graphics 
modes. The new display modes take ad va mage of the anaEog RGB 
video output to produce high-quality, high -resolution color 
graphics. Table 2-5 lists the specifications of the two new r graphics 
display modes 
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Table 3 6 

Super HI -Res graphics modes 





Resolution 


Bl!» per 


Colon 
pwlln* 


Colon 
en icrran 


Colon 


Mod* 


Horiz. Verl. 


poisibSn 


320 

640 


520 200 
640 200 


4 bits 

2 bits 


16 


256 
256* 


4,096 
4,096 



•Different pixels u-ue different p*rts of* the palette. 

In the new Super Hi-ftcs graphics modes, colored dots havei the 
same horizontal resolution as black-and-white dots. Ghat's 

different from the standard Hi-Res and Double Ill-Res graphics 
modes, where colored dots are effectively wider than black-and- 
white dots.) Each dot on the Super Hi-Res screen corresponds to a 
pixel, and pixels are indivisible: the screen does not display 
individual bits. 

Each pixel has cither a 2-bit (640 mode} or a 4-bit (320 mode) value 
associated with it. as shown in Figure 2-4, The pixel values select 
colors from programmable color tables called palettes, A pa lent? 
consists of sixteen entries, and each entry is a 12-bit value 
specifying one of 4096 possible colors In 320 mode, color 
selection is quiic simple: each pixel consists of Four bits, so it can 
select any one of the sixteen colors in a palette. 
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Figure 2-4 

Bits In pixels 



22 



Chapter 2: Hardware Features 



Dllhorlfig Is p technique to* 
otornairg "no vc .jcs o 4 
adjacent ottois to cre-ato- the 
sffecf of more color*. 



In 640 mode, color selection is more complicated. The 640 pixels 
in each horizontal line occupy 160 adjacent bytes of memory, and 
each byte holds four pixels thai appear sitJe-by-side on ihc screen. 
The sixteen colors in the palette are divided into four jpftups of four 
colors each. 'I he Just pixel in each horizontal line can select any 
one of Tour colors from the third group of four [n the palette. The 
second pixel select.? from the fourth group of four colors in the 
palette. The third pixel selects from the first group of four colors, 
and the fourth pixel selects from the second group, as shown in 
Figure 2-5. The process repeats for each successive group of four 
pixels in a horizontal line. Thus, even though a given pixel can be 
one of onty four colors, different pixels in a line can uke on any of 
the sixteen colors in a palette Using a technique called dithering, 
software for 640 mode can take advantage of this color-selection 
scheme to display 16 -color graphics on the same screen with EQ- 
column text. 
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Figure 2-5 

Color selection In 640 mode 
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To further increase the number of colors available on the display, 
there can be as many as sixteen different palettes En use at the same 
rime. Each oFthc 200 horizontal lines of pixels can use any one of 
the palettes, giving as many as 256 different colors ax once. All the 
palette information occupies memory adjacent to the display data- 
a picture and ils palette are normally saved together. 

$■ jV3f£ In 320 mode, there is a graphics fill option that enables a 
program to fill any portion of a horizontal Line with a new color 
simply by setting marker values on the boundaries of the flU 
area. Because individual windows usually don't conu-r>! the 
entire width of the screen, this technique is not useful In a 
window environment- On the other hand, if you are writing a 
graphics package thai uses the entire scrcen h you might want to 
consider using it. 



Sound capabilities 

The Apple NGS has more powerful sound-generating circuits than 
any previous Apple computer, although programs that generate 
sounds with the single^blt sound output of earlier models of the 
Apple II will still work on the Apple UGS. 



Single-bit sound 

The standard Apple II sound output consists of a single blt H and 
programs produce sounds by switching that bit on and off. Tn the 
Apple IlCS f you can also adjust the volume of the sounds generated 
this way, by using the Control Panel or by making a call to the sound 
tools. 



Digital synthesizer 

In addition to the old single-bit sound output, the Apple lies has a 
new digital sound system that indudes a special-purpose synthesizer 
1C called Lhe Distal Oscillator Chip, or DOC for short The Dtx; 
which is made by Ensoniq and used in their line of music 
syrthcslzcrs, generates sound waveforms from digital samples 
stored in HAM. Using the DOC, the Apple UGS can produce multi- 
part, multi- voice musk and oiher complex sounds without tying up 
its main processor. 
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Figure 2-6 is a block diagram of Che sound system of she Apple IIGS, 
The sound system consists of the DOC, an audio amplifier and 

internal speaker, a connector for an external amplifier and speaker, 
64K of independent ItA_Vt for storing sound samples for the DOC 
and a custom IC F the Sound CLU (General Logic Unit)- The Sound 
GLU chip functions as the system Interface to the DOC- in addition, 
it gives the Apple HGS the ability to control the volume oF sound 
from the old-style singte-bit output. 
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The DOC contains 32 individual oscillators, each of which 
generates a signal by stepping through a table of digital samples of a 

sound. In the Apple I ECS, one oscillator is used as a dedicated dock 
for the. DOC and one is reserved For Future use, leaving 3Q. Even 
though each oscillator can produce sound independently, it takes 
two oscillators to produce a continuous instrumental voice, so in 
normal use the DOC can produce up to 15 voices. 

The DOC also has a single analog la-dlyii.it convener (ADO If a 
properly conditioned audio signal is connected to the input 10 the 
ADC, the DOC can record digital samples of sounds for later 
playback by the DQC's oscillators. (You can condition the signal by 
using a low pass Filter with a cutoff no higher than 14 kHz or by 
adding a sampEc-and-huEd circuit that is synchronized to the DOC r s 
clock.) 



Sound capabilities 
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Built-in crock 

The Apple lies his a built-in real-time clock with battery back-up 
during power interruptions. The user sets the time and date by 
means oFthc Control l x aneL ProDOS uses the dock to ser daie and 

time in flies. 

* Note to developers: The Apple IIGS clock does not use the same 
commands as the various third-party dock peripherals. 
Applications can call ProDOS and get the time the same way as 
on an Apple He, or they can determine which system they am 
running on and use the calls appropriate to the dock on that 
system. 
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This chapter describes the I/O features, which have both hardware 
and firmware aspects. As in Chapter 2, The emphasis is on the new 
features. You can Find further descriptions of the VO features in the 
manuals Apple fids Hardware Reference and Apple HGs 
Firmware Reference. 



I/O expansion slots 

Except for the Apple He, ail models of the Apple El have T/O 
expansion slots. The original Apple II and the Apple II Plus had 
eight slots, numbered through 7. The Unguage Card normally 
occupied slot on those machines. On later models, including the 
Apple IJGS, the language-card memory ■* built in and there arc only 
seven slots, numbered \ through 7. 



Slots on the Apple I1GS 

The I/O expansion slots an? designed to accept circuit cards that 
contain hardware and Firmware to control and communicate whh 
peripheral devices. The slots are not simply I/O ports > a card in a 
slot has access to the clock and control signals, the data bus, and 
the low-order 16 bits of the address bus. The same signals are 
available on all the slots, except fur the color subcarrier, which is 
only on slot 7. In addition to the common signals, each slot has its 
own select signals, which are separately decoded fur each slot- The 
slots on the Apple TIGS are almost Identical to the stots in an 
Apple lie, and can accept most Apple H peripheral cards. CTwo of 
the slot signals, Inhibit and Sync, work differently on the 
Apple IIG5, and there is a new signal, M2£clcct; please refer to the 
Apple lies Hardware Reference for more information,) 

As Far as the slots themselves are concerned, any peripheral card 
can operate in any sloL However, it has become conventional to 

use certain cards in certain slots: for example, printer interface in 
slot 1, 80-CCtfumn display in slot % and disk controllers in slot? 5 
and 6 Even though later modeLs of Apple II have these I/O 
Interfaces built in 1 eompatibiliiy requires them to have the same 
kind of program access that was originally designed for cards in 
slots. 
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*■ Peripheral-card compatibility: Only the low-order J 6 bits of 

[he 24-blt address bus are available on the expansion slots. 
Peripheral cards that derive iheir enabling signals by decoding 
the address bus will not work in [he Apple IIgs unless ihcy also 
use one oF [he select signals to verify I hat the address on the bus 
is in the appropriate 64 K bank for I/O Cthat is, bank 3E0). 



Apple II slot memory 

This section briefly describes the memory spaces allocated to the 
slots. Except for their Location in bank 5E0 and the consequent 
need for shadowing to be on for old-style programs to work, the slot 
memory locations in the Apple IIGS are the same as on any other 
model of the Apple II. If you need all the detaiis about slot memory, 
refer to the manual Apple lies Hardware Referents. 

♦ Shadowing for I/O: In the Apple I1GS, I/O uses memory 
locations in bank $E0 To make those locations available to 
6502-based Apple II programs, which run in banks SCO and $01, 
the Apple 13CS has a feature called I/O shadowing that makes 
load tod stow instructions to locations in bank $00 also 
happen In bank $£€. For mote information about shadowing, 
see the section p Memory Shadowing" in Cfiapter 6. 

<* Apple II. The test or ihis seeuon describes the way the 

expansion slots work on all models of the Apple II. If you art 
already familiar with the Apple II„ you might as well skip ahead 
to the next section. 

The microprocessor In an Apple II does all its I/O through memory 

locations. To make the slots accessible to the processor, pans of the 
memory space am allocated to the slots, tn addition to the memory 
locations used for actual I/O, there are memory spaces for 
programmable memory (RANI) and for read-only memory (ROM) 

on chr: cards, as described below. 



I/O expansion slots 
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PBOM ttoodl tor programmable 
tQud-onty memory, o typo of 
ROM device designed to bo 
programmed after fatuseatlon, 
unliko ore ncry 10 V ac-viccs. 
whlcn ore programmed during 
fabric a Man. 



Slot I/O space 

Each expansion slot has the exclusive use of 16 memory locations 

Tot data input and output- The lfi locations for a given slot have 

addresses $C08x * sO, where x stands for hexadecimal values From 
to F and £ stands for the slot number. Ftgurc 5-1 shows the 
allocation of I/O addresses Tor the slots: for example, the UO 

addresses for stot 3 are 3COHO-5COBF. Whenever one of those 

addresses appears on the address bus, the slot hardware activates 
the device select signal in that sloL The circuits on the card can use 
the device select signal and the low-order four bits of the address to 
activate devices on the card. 
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Figure ^-1 

Slot I/O device locoPioos 



Slot ROM space 

Each expansion slot has the exclusive use of one 256-byte page of 
memory space, Most peripheral cards use this space for ROM or 
PROM for storing the driver routine that controls the operation of 

the peripheral device. 

The 256 ROM locations for a given slot have addresses SCs(X\ where 
s stands for the slot number. Figure 3-2 shows the allocation of ROM 
addresses for the slots: for example, the ROM addresses for slot 3 
am SC300-SC3FF, Whenever one of those addresses appears on the 
address bus, the slot hardware activates the I/O select signal in that 
slot That signal enables the ROM device on the card h and the low- 
order eight bits of the address bus determine which of the 25o 
locations is being addressed. 
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F&j mora details, refer to The 
chapter 'Pfogmmrnslng lor 
Padphera! Cards' In the 
Ap&6 ire technical ffeferancB 
Manual. 
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Figure .3-2 

SJot ROM locations 



Expansion ROM space 



In, addition to the .small ancas of memory allocated lo each slot, 
[here is a 2K memory space from $0800 to $GFFF that can be used 

by a card in any slot More [han one peripheral card can have 
expansion ROM on. it, t>ui only one of them can Ire active at one 

time. 

Lach card that has expansion BOM on it must ilso nave a circuit lhaL 
uses the I/O select and I/O strobe signals on ihe slot to enable ihe 
ROM, Ihe card muse also have a circuit to disable the BOM so thai 
other cards can use the same addresses for their expansion ROM. 



I/O expansion slots 
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Slot RAM space 

Besides the various locations allocated for devices on peripheral 
cards, a few locations in main memory arc reserved for variables 
Used by the peripheral-card routines, These locations are called the 
screen holes. Each slot gets one byte in each of the eight small 
blocks of text-page memory, as shown in Figure 3-3 To determine 
the addresses of the eight RAM locations assigned to a particular 
slot, add the slot number to the starting addresses of the blocks. For 
example, the BAM locations for slot 1 are $(tf 79, 504 1=9, $0579. 
S05P9, 50672, $06F9, $0779, and SQ7F9. 

* Screen hotes: The text display buffer (text i ] age 1} occupies 
memory from S0400 lo $07FF h but there are locations in that 
range thai arc neither displayed nor modified by the firmware's 
display subroutines (for example, OOtTDJ. Those locations are 
called the screen holes, and are used for temporary' storage 
cither by I/O routines running In peripheral-card ROM or by 
firmware routines addressed as if they were in card ROM. 
(Application programs never use thus area of memory.) 
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The Apple lies Hardware 
BefsroncG and Jhe Technical 
re'erencg manuols for The 
Apple He and The Apc*e lie 
describe in aef all now a 
peripheral card routlr%e goes 
about determining its slot 
number 



The Apple liGS Owner's Guide 
gives a complete description of 
the use of The Control Panel. 



Finding 1h© Slot number 

The ROM routines an a peripheral card often need To know which 

slot the card is in. One way to do This is to execute a J5R (jump eo 
subroutine) instruction to a location with an RT5 (return from 
subroutine) instruction in it, then gel ihe return address From the 
stack and derive the rial number from that, using the formula given 
above in the earlier section "Slot ROM Space. - 



Serial I/O ports 

The Apple uTCS has two built-in serial pons that can substitute For 
slois 1 and 2. Ry using the Control Panel desk accessory, the user 
can select either the built-in port Of (he card Tor either sloL A built- 
in port can operate while there is a peripheral; card plugged into the 
corresponding slot, but the pon and the card cannot both run it the 
Same rime. 

The hardware for the serial ports consists of a two-channel Serial 

Communications Converter (Zltog 8530} and KS-422 driver ICs 
connected so as to be compatible with RS-2^2 devices. The 
firmware fur the ports emulates the functions of the Super Serial 
Card and the Apple lie serial-port firmware. The Firmware provides 
input and output buffering aa well as background printing, as 
described below. 

The ports are normally configured such that port 1 is a printer port 

and pan 2 is a communications port, but either port can be 
configured either way by using [he Comrol Panel desk accessory. 
{Alternatively, the user can connect either one of the ports to 
AppleTalk: see the section "AppleTalk Interface" Later in this 
chapter.) 



Apple If serial ports 

*■ Apple lh This section describes the way the serial pons work in 
Other models of the Apple EL IF you are familiar with the 
!>ptT.ii m of the Apple Super Serial Card or the serial ports on 
The Apple He, you might as well skip ahead to the section "New 
Serial Fori Features," 



Serial I/O ports 
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DCD. D5R. ond F>TE stand rcr 
data carter cfeJecf . data Set 
ready, cmd data terfnftof reaoy, 
respecTlvely. which are names 
a* signal on the sa-lal por's 
XON and XOFF ore Two control 
characters. I/O driver routines 
usa Those signals or thoss 
characters For hand shaking, 
thaT Is, controlling rhe transfer 
of da^a between the computet 
and the peripheral devlcfl. 



This section describes ihe basic functions of the serial I/O ports. 
Those functions are the same on the Apple I EC S as on other 
Apple H's with bulU-in ports, even though their hardware 
implementation is different. For complete descriptions of tin- srn.ii 
ports, refer to the manual Appte ilGS Firmware Reference. 

Both serial ports are general-purpose I/O ports h compatible with 
RS-252 standard devices, Serial pon I is iniialliy set up as an output 
port for a printer or planer, and. serial port 2 as a communications 
port for a modem- Table 3-1 shows the settings. The user can 
change the characteristics of cither port by using the Control Panel 
desk accessory. An application can change port characteristics by 
means of commands, as summarized in Table 3-3 and described 
fully in the Apple IIGS firmware Rcferunce. 

Tabi#M 

Initial settings for sorlal ports 



Character I illc 



Pod 1 



Pon 2 



Line length 

Delete line feed after carriage return? 

Add line feed after carriage return? 

Echo nutput to display screen? 

Buffering an? 

Data transmission rale 

Number of data bits 

Number of stop bits 

Type of parity checking 

DCD type handshaking enabled? 

DSH/DTR handshaking enabled? 

XON/XOFF handshaking enabled? 

Command character* 

The Control Panel can'L change the command character. You change the 
command character hy sending the cuncnt command character followed 
hy a conUol character, which becomes the new command character For 
more information, sec the following section. 

Serial port commands 

There are two ways of controlling a serial port. One way, commonly 
used by Applesoft programs or from the Monitor, is to activate a 
port or slot by means of the Input and Printer commands, as shown 
in Table 3-2, and then send command characters in the output 
stream, as shown in Table 3-3, 
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Important 



tn Taalss 3-2. 3-d. and 3*5. fhG 
*?lE>r s stan as for The port 
number, either 1 or 2. 



1 



The second method of controlling a serial port Is by the 
standardized firmware protocol Your program mike* calls to 
command routines whose, addresses your program has found in 
standardized locations derived from the slot number. The firmware 
actually contains [wo separate interfaces, one for Applesoft RAStC 
and one, called the Pascal 1.1 interface, for other languages. 
Tables 3-4 and $-5 summarise the two interfaces to the firmware. 
For complete descriptions, refer to the Apple lies Firmware 
Reference, 



The manuals for the Super Serial Card and for the Apple lie ol» 
list haidwafe registers and screen-hole locations Tor controlling 
the ports. I* you want your programs to njn properly on the 
Apple lies and on future models of the Apple II. do not control 
the ports by means oT the hardware: use calls to the firmware or 
use the toolbox. See lhe sec Hon "Serial Port Compatibility." 

Table 3-2 

Input and Printer commands 



Function 



Appltiofl command Monitor command 



Start inpm on port s lN*s 

Start output on port S P ll*s 

Table 33 

Summary of I/O commancs 



s Control-K 

s Control-P 



Command Description 



nnnX 
nnB 



nl) 



I-' 
I 
K 



Set line width to ruin 

Set baud rate to one of 15 standard values selected by 
nn Lowest rate is 50, highest is 19,200. 

Send automatic carriage return whenever line width 
exceeded 

Set data formal— number of data bits and slop 

bits — to setting specified by n. Data hits can be 5. 6, 
7 F or B-; stops bits, 1 Or 2. 

Disable keyboard to prevent disturbing input 

Echo output to display screen 

Disable automatic line feed after carriage return 



Serial I/O ports 
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For complete descriptions of the 
Interfaces to the serial I/O 
famwaie. refer to the Appts fiGS 
flrmwore rtere/enee. 



Table 3-3 (continued] 
Summary of I/O commands 



Command Dticripllon 



I. Generate automatic line feed after carriage return 

M Mask out (delete) incoming line-feed characters 

nP Set parity as selected by n. Parity can be even, odd, 
mark, space, or none. 

Q Quit (turn ofD terminal mode 

R Reset port 

S Send a break character 

T Enter terminal mode 

X Turn on XON/KOFF I/O protocol 

2 Zap (ignore) further commands until Control-Reset 



Table 4-4 

Address locations foe BASIC protocol 



Addrecs 



ft«scrlpllon 



5CsOO 
SCs05 

5Cs07 



Initialization routine (also outputs a character) 
Read a character 
Write a character 



Table 3-5 

Address locations for Pascal 1 . 1 pratocot 



Addreu 



DtitcMpllon 



SCsOD 
$CsOE 
$CsOF 
$CslO 
SCSI 2 



Offsei tn initialization routine (PInit) 

OIFset to read routine (PRead) 

Offset to write routine CPWrite) 

Offset to status rouLJne CPStatus) 

Offset to control routine for extended interface 



^ /Vo/fr To obi am the address of lhe desired routine, read the 
offset byte from the address given in the table and add it to the 
slol address, SCsfjCk To use the extended interface, set up a 
command Hist and ihcn use a JSR to jump to the address of the 
control routine, as described in the Apple fl<25 Firmware 
Reference 
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Terminal emu f at ion 

Tne Apple lies firmware supports a terminal emulation mode that 
works like the one in the Apple lie The terminal emulation has a 
minimum of features, and is intended for use only when a iull- 
feaiured communications package is not available, The terminal 
emulation pusses characters typed on the keyboard {except 
command strings!) to the serial output* and passes serial input to the 
display. 

The user puts the Apple lies into terminal mode through the BASIC 
interface by typing 



where sis the port number and cis the command character {usually 
Control -I for the printer port or Control- A For the communications 
pen). The letter 7" is the terminal command, as shown in Table 3-5, 

To quit terminal mode, the user types the command character 
followed by the letter Q, the Quit command. 

When running terminal emulation at high baud rate, you can use the 
firmware's buffering features (described below) to keep from losing 
characters during display scrolling. 



New serial port features 

The serial pons on the App&e JIGS have several new features in 
addition to the ones found on the Super Serial Card and the 
Apple lie. The new features include 

□ I/O buffering 

□ background printing 

□ built-in AppleTalk interface 

Thts section describes the new features briefly; for more 
information, refer to the manual Apple UG& Firmware Reference. 

I/O buffering 

The serial-port Firmware supports input and output buffering. Each 
port has an input butter and an output buffer. The default buffer size 
is 2K, which the firmware requests from the Memory Manager, but 
an application can request larger buffer (up to 64 K) and pass the 
location and size to the firmware. 



Serial I/O ports 
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ApptoTalk i $ ApO'e'-s "ocal-areo 
network for La ssf Wilted ana 
rrnageVvrit&r ,w II printer* and 
App'9 II ano Macintosh 
computers. Like the Macintosh. 
The Apple iiss hes frig AopleTqlk 
inter race buiii in. 



A data overrun occurs when 
snput dota comes faster than 
the computer con accept It. 



There are four ways to turn on buffering: 

□ from the control panel 

D from the keyboard after the Applesoft PR* command 
D from an application by a command in the output stream 

□ from an application by a command to the serial firmware 

Output buiTcrLna; puts characters in a FIFO (first-ln, first-ouQ queue 
In the output buffer space, then sends them on to the output device 
whenever it is ready. Input buffering puts characters into a queue in 
the input buffer and responds to calls to the firmware's Read routine 
with characters from the queue. 

Although the application is not involved In the interrupt process 

that the firmware uses to support buffering, the application can keep 
track of buffer activity by nuking extended-interface calls that return 
the number of characters in the input, queue or the amount of space 
left in the output queue. O "hose calls are InQStatus and OutQStatuSi 
refer to the Apple IfGS Firmware Reference for descriptions.) 



Background printing 

The firmware can send a block of characters out a serial port while 
an application is running. This background printing is similar to 
output buffering except that the firmware accepts a targe number of 
characters all at nncz instead of getting them one at a time. When 
the firmware transmits the last character In the output buffer, it calls 
a recharge routine, supplied by the application, that refills the 
bufTer. As with normal buffering, the application can either use the 
default 2K buffer or request its own buffer of up to 54K from the 
Memory Manager. 



AppleTalk interface 

The user can connect the AppieTalk network to either one of the 
serial port connectors and activate it by means of the Control Panel 
desk accessory. At an^ given time, only two of three t/O 
functions — AppleTalk, serial port 1, serial port 2 — can be active. 
(The Control Pane) cnsuies that one serial pon is made inactive 
when AppleTalk is selected.) 

So that the Apple IJG5 can support AppleTalk, the interrupt service 
routine is designed to respond to the serial-port hardware fast 
enough to preclude data overruns. In addition, a hardware timer 
generates a system interrupt four times a second to enable the 
AppleTalk firmware to carry out network operations. 
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Thetcroen hoEvs ore locations In 
rh& fsrf display page that ar& 
us&d by rhe ROM on cards In 
expansion slots, ui described In 
itie earlier section 'Slot RAM 
Space" 



Serial port compatibility 

Even though Lhe commands used to communicate with (he serial 
port firm warn are the same as those in the firmware on the Super 
Serial Card Cand similar to the ones in the Apple Mc) p some existing 
programs using these ports wiLI not be compatible with the serial 
ports on the Apple lies. The reason is that many programs, 
especially communications packages, bypass the firmware 
commands and go directly to the hardware. Programs that control 
the hardware directly wont be compatible with the Apple TIGS, 
because it use* the 8530 Serial Communications Chip (SCQ, not the 
6551 Asynchronous Communications Interface Adapter OVCIA) 
used in the Super Serial Card and the Apple Ik. 

Programs that use the port to control a printer are more likely to use 
the firmware commands, making them compatible with the 

Apple [JfJS. The same goes For most applications written in 
Applesoft or Pascal. Apple works™ and MousePaint™ are examples 
of programs that control the pons by calls to the firmware and so 
arc compatible with the Apple IIGS. 

Even programs that use the firmware can get into trouble if they 
communicate with the firmware by modifying the contents of \ht 
screen holes. The serial-port firmware takes the place of ROM in 
slots 1 and 2, so it uses the screen -hole locations for those slots. 
Rather than making proper calls to the firmware, some programs 
control the operation of the firmware by changing the values in 
those locations. While that may work on a particular model of 
Apple II, the firmware in another model may not react the same 
way. For complete information about the serial ports, refer to the 
manual Apple //c75 Firmware Reference. 



Built-in disk port 

The Apple HCS has a built-in disk port like the one on the Appte He. 
The disk port uses an IC called (he IWM (Integrated Woa Machine) 
and can handle up to sbt drives, connected in a daisy chain. The 
drives can inctude one DuoDlsk* Cwhich counts as two drives), up 
to two UniDisk™ drives, and Tour UniDisk 3.5 or Apple 3.5 (unified) 
drives. 

<* ,'Vore; Disk II* 5-25-inch drives won't work with (he built-in port 
because their connectors won't fit Ihey work fine with a Disk II 
controller card installed in an expansion slot. 



Built-in disk port 
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BPQt Is short For bootstrap land, 

a term jugrjesflve or lhe 
dlrflcurty of InsNgl lOodlrtQ Of 
loader programs into early 
computers that didn't hove 
built-in firmware In ROM 



O Apple ff The earliest Form of disk storage available for the 
Apple D consisted of Disk II controller cards and Disk 11 drives 
using 5-25- inch floppy disks with 143K storage capacity. Each 
controller card could handle one or two drives^ for more than 
two disk drives, you needed additional controller cards. The 
conventional location for the first controller card was slot 6;. the 
second card went in slot 5. For initial loading (booting) from 
disk r the startup routine in the firmware started with slot 7 and 
tried successively lower-numbered slots until it found one w^th a 
disk control ter card in it. Most software for the Apple II was 
designed to use slot G t drive 1 K as its startup drive. On more 
recent Apple N's that have a built-in disk interface, The slot and 
drive nomenclature Is less meaningful, but it is stilt the 
convention because so many programs designed that way are 
still in use. 

The disk-port firmware handles drives addressed as internal slots 5 
and S. You can also instaU a disk interface card in slot 6 and Itave 
two additional 5.25-Inch drives (although you can't use all the 
drives at the same time). You can boot the Apple IIGS from drive 1 
in either slot. Using the Control Panel desk accessory', you can 
determine whether the firmware will look for the boot device in 
slot 5. in slot 6, or scan downward from a specified slot. 

The disk-port firmware also controls /RAM5, a block-storage device 
emulated in RAM and activated as slot 5 h drive 2. When /HAM 5 is 
active, the firmware accesses the second 3-5- Inch disk drive as 
slot 2 k drive 1. See Appte lies firmware Reference for information 

about HAM disk. 



A block I/O' dtvlc* mods or 
write* Information m organized; 
groups called blocks, typically 
&12 bytes. A disk drive 4 a block 
oevlce 



SmartPort and Protocol Converter 

SmartPort is a set of assembly-language routines used to support 
block I/O devices, The SmartPort firmware includes the Protocol 
Converter software used in the Apple lie 3.5 ROM revision. 
SmartPort supports two 5-25- inch drives, two Apple 3-5 drives* up 
to 127 UniDisk 3-5 drives, and the RAM disk volume /MAM5- CThe 
disk-port hardware can handle a maximum of sis drives,) 
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Applications can mike calls to ihe SmartPort to perform the 
following functions: 

D obtaining ^'y[u.h information about a device 

n rescuing a device 

□ formatting ihc medium in a device 

□ reading from a device 
D writing, lo a device 

ho. ruling COiUfO] information to t devke 

Gills to SmanPort use ihe same technique as Lhe Pascal l.l protocol 
summarised in Table 3-5, except the address values are in the slot 6 
locations. For complete information about 5mariPort h refer to the 
manual Apple HGS Firmware Reference. 



Game I/O connectors 

The game I/O connectors can be used for attaching one or two pairs 
of hand cone rollers or game paddles, one or two joysticks, a 
graphics tablei h or a similar I/O device designed for use with 
AppEe II cornputers- 

* Note.- Similar I/O devices designed for the Apple lies can be 
connected to the DeskTop Bus, which is described in the next 
section. 

Like the Apple He, [he Apple JIGS has two game I/O connectors: a 
9 -pin miniature D-jypc connector on the back panel, and a ItS-pin 
DIP socket on the main circuit board, inside ihe case. "JTie 9-pin 
connector has four analog inputs (used for hand controllers or in 
pairs for joysticks), three button inputs, power, and ground. The 
16-pin socket has the same signals as the 3-pin connector plus a 
strobe and four single-bit outputs. 



Apple DeskTop Bus 

The Apple DeskTop Bus Interface is a simple I/O interface with two 
different but related functions. Its primary function is to provide 
intelligent support for the keyboard and [he DeskTop Bus mouse. It 
also provides a convenient way to connect additional input devices, 
such as hand controls, graphics tablets, numeric keypads, and 
Other keyboards. 



Apple DeskTop Bus 
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A DIN connector Is a rype of 
conne-ctof wl'n multiple pins 
Inside o round outof shield. Tne 
Initials DIN aland for Deutsche 
tnaUtfrte Normai, a Eureoean 
slandords organization. 



Tne Dvorak typewriter 
keyboard, also called the New 
Arrterterftn Sfdndard JfeyooardV 
has its keys a/ronged such mat 
It Is more effelemr to use then 
the more common Owerty (for 
the nrst line of Keys) keyboard 
arrangement. 



The DeskTop Bus is a serial interface (not a standard serial I/O pon) 
that is controlled by its own built-in microprocessor the Apple 
DeskTop Bus CADE) microcontroller. DeskTop Bus devices use 
inexpensive four-conductor cables and four-pin miniature DIN 
connectors. Additional devices connect in parallel with devices 
already installed^ some devices, such as the detached keyboard, 
include a jack for connecting other devices. The different types of 
devices have different identifiers; if there are two devices of the 
same type, the ADB microcontroller assigns them different 
identifiers. 



Detached keyboard 

The Apple IlGS keyboard is rhe new Apple standard detached 
keyboard. The new keyboard layout includes several 
enhancements, most notably a numeric keypad. It also conforms to 

European standards in the shape and position of the Return and 
SWfl keys. 

The Apple DeskTop Bus microcontroller (ADB microcontroller} 

supports the detached keyboard, providing basic scanning and 
encoding along with special features such as a type-ahead buffer. 
The ADB microcontroller supports eight diJTerent keyboard 
layouts, making it easier to localise the Apple IIGS for other 
countries. The ADD microcontroller also supports the Dvorak 
keyboard layout, which the user can select by means of the Control 
l J ancl desk accessory. 

With the Apple IIGS Upgrade installed in an Apple tte, the ADB 
microcontroller supports the built-in keyboard, providing the same 
features that are available with the detached keyboard 



Mouse 



The DeskTop Bus provides an improved interface for the 
AppleMouse. Although the actual mouse hardware is unlike that 
on either the Apple 13c Apple-Mouse card or ihe Apple lie, the 
calling sequences are the samc h as required for program 
compatibility. 
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For oppllcarionj uslrtg trie 
DeskTop Bus, there is o DeskTop 
Bui tool set. 5e& Ch-oorer 5 for 
.■nore Informolion. 



VW is srtort for vetoed Waning.- 
It Is an Intemjpl signal 
generated fry the vIpqo riming 
elrctft each time it tmshes a 
vertical seen The vertical scan 
hpppeni io tlrnai a fiecc-nd, ia 
VBL Is a convenient way to 
confrol the frequency of ottw 
ovenis, such as mouse 
Inrerfupfi. 



The AppleMouse contains a microcontroller thai keeps track of the 
movement of the mouse up to plus-or-minus 63 Increments fcfcWFD 
and repons mouse information to the DeskTop Bus, which passes I 

on the the mouse routines in the firmware. Like the AppleMouse 
card for the Apple He (and unlike the mouse interface on the 
Apple lie), the ADR controller reduces the burden that operation 
of the mouse place* on the main processor, as described in the nexl 
section. 



DeskTop Bus firmware 

The DeskTop Bus firmware provides communications and control 
J. r 1 he detached keyboard (along with the built-in keyboard when 
the Apple lies Upgrade is installed in an Apple He) and the 
DeskTop Bus mouse Jt also acts as a simple communications 
interface for other input devices such as Joysticks and graphics 
tablets. 

The firmware supports mouse operation*! in somewhat the same way 
as the AppleMouse card Tor the Apple Tie. Ufee ihc ApplcMouse 
card, the Apple DeskTop Bus supports interrupt-mode operation of 
I he mouse, waiting until VBL occurs before interrupting the system. 
It also provides a true passive modd that is, a mode in which the 
mouse interface doesn't interrupt the application, but waits for the 
application to poll! 1. Using passive mode, applications can 
operate the mouse while running software routine*: That mustn't be 
interrupted, such as critical timing loops. 

For complete information about the operation of Apple DeskTop 
Bus, refer to the manual Apple HCs Firmware Reference. To find 
out how to connect a device to Lhe bus, refer to the Apple UGS 
Hardware Reference. 



Apple DeskTop Bus 
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Firmware 
Features 



The Desk Manager, which 
controls The desk accessor es, s 
dBicbBd In Chaptsr 5, "The 
Apple lies Toolbox,' The 

Appf& iISS Owner's Guttfe 
describe* the ope^aNgn or the 
ConSrol Panel by ihe user, the 
Apple KGS Ritt\v/qi& &Qf&f$tfi£& 
describes the operation of She 
Control Pone3 bv an application. 



The Apple l\CS has a total of 12BK bytes of ROM for firmware; 
permanently resident programs. The Firmware includes the 

following features: 

Li driver programs for built-in I/O ports 

□ resident desk accessories 
n Monitor 

□ Monitor I/O routines 
D resident toolbox 

d Applesoft UASIC interpreter 

This Chapter describes only the resident desk accessories, the 
Monitor, and the Monitor I/O routines, The built-in I/O pans are 
described in the previous chapter, The toolbox is described in 
Chapter 5 and in the Apple UCS Toolbox Reference, Volumes 1 
and 2. Applesoft BASIC has its own manuals: Applesoft Tutorial, 
Applesoft Reference Manual, and BASIC programming With 
FroDOS, 



Resident desk accessories 

D^k accessories arc programs^ usually ^niall, that the user can 
invoke to perform some immediate task when some larger program 
is running. When the desk accessory is finished, the interrupted 
program can continue. Most desk accessories are Loaded from disk 
and reside in RAM, bat there are two that arc penmanendy resident 
in ROMl the Control Panel and the Alternate Display Mode. 






Control Panel 

The Control Panel is a permanently resident desk accessory that the 
user can invoke while another program is running. The Control 
Panel enables the user to specify the operating parameters for the 
following functions; 
D I/O ports: primer or modem, line length, baud rate,, and so on 

□ display; 40 or 80 columns- colors fur test, background, and 
border 

a pitch and volume of sound to use for bell 

□ operating speed: I MHz or 2.5 MHz 

z- slot allocation: internal pons or peripheral cards 
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li startup slot 

□ language (character scO for keyboard and display 

D built-in dock: lime and date 



Alternate Display Mode 

'["he Alternate Display Mode is a small firmware routine that dan be 
activated from the Control Panel. It makes ihe Apple IIGi 
compatible with standard Apple II programs that create animated 
displays by rapid alternation or (lipping of the two Lo-Res graphics 
pages. 

Standard Apple ir programs running on ihe Apple \lc,$ normally 
can't display jext Page Z (also known as Lo-Ecs graphics Page 2) 
because the hand ware dees not shadow it. Jf such programs use page 
flipping for Lo-Res animation, the display won"i took right unless 
they can display text Page 2 To run the programs on the 
Apple IlGS h the user must first turn on Alternate Display Mode h 
which periodically transfers data from text Page 2 in bank $00 to the 
same area of bank 51:0, where ir. can be displayed. 



The Monitor 

'Ihe Monitor is a built-in pmgram Lhat provides machine-language 

access to the registers and memory. The Monitor includes firmware 
I/O routines to accept commands typed at the keyboard and to 
display text on the screen. Iliese I/O routines provide tow-level 
input and ouiput functions that application programs can also use^ 

see the next major section, "Monitor I/O Firmware/ Even though 
the mini-assembler and disassembler are considered parts of the 
Monitor, this section describes them separately, after the other 
features of Lhe Monitor. 



Usfng the Monitor 

<* Apptell This sccdon describes features that are common to 
the Monitor programs on all models of the Apple II. If you are 
already familiar wim the Monitor, you might as well skip ahead 

to the section 'Xew Monitor Features. M 



The Monitor 
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The Monitor is a built-in utility that enables a programmer to 
examine code and data in memory and to execute portions of the 
code. The Monitor program occupies memory in ROM bank $FF, 
starting at location $FFo9 MSI). That pan of ROM is mapped into 
banks SOD and $01 by the language-card switches when Applesoft 
BASIC or other standard Apple II programs are running. One way 
to invoke the Monitor is to have Applesoft running and type 



When the Monitor is running, the prompt character is an asterisk 
(*). When you are Finished using the Monitor, you return to 
Applesoft by pressing Control- Reset or Control -C. 

The Monitor does not support the desktop user interface. To give a 
command to the Monitor, you type a line at the keyboard and press 
Return. Commands contain three kinds of inform adon: addresses. 
data values, and command characters. Addresses are in 
hexadecimal data values can be in hexadecimal or in the form of 
ASCfl characters. 



Monitor commands 

* Apple II- This section describes features that are common to 
the Monitor programs on all models of the Apple 31. IT you are 
already familiar with the Monitor, you might as well skip ahead 
to the section "New Monitor Features.' 

Like the Monitor programs in all other models of the Appte II, the 
Apple ]IG5 Monitor allows programmers to operate on programs in 
memory at the lowest level The Monitor includes instructions to 

D display the contents of a memory location 

□ display a range of memory locations 
n store values starting at a location 

D display the contents of the regis i ^ rs 

□ change the contents of the registers 

□ move a block of memory 

□ compare {verify) two blocks of memory 

□ direct Output to port or slot H 

! i accent input on slot or pon n 

D execute program code starling at a location 

□ disassemble code starling ai a location 
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Tho Tool Locator is dgscrlb&d In 
Chapter 5. 



For dGSCtipjions of the Monitor 
commands, refer fo tho chapter 
Or rhe Monitor In the App}& Ugs 



New Monitor features 

Among the new features of the Apple JIGS Monitor are 

□ new command* 

P improved display 

a extended memory addressing 

The Apple IICS Monitor also includes enhanced versions of the 
Apple II mini-assembler and disassembler, which are described 
later 



New commands 

The Apple lies Monitor has many new commands. Among them 

are commands lo 

P save and restore registers and mode settings 

□ search memory for a pattern up to 256 bytes long 
D fill part of memory with a one-byte value 

make i call to the Tool Locator 
a store a new value into a spcdFic register 

□ enter ASCII characters from keyboard into memory 
Q change ihc setting of the real-time clock 

□ convert hexadecimal to decimal or vice versa 

□ perform 32 bil addition, subtraction, multiplication, and 
division 

a switch between native and emulation modes 

Improved display 

Many of the Monitor commands display the contents of part of 
memory on the screen. The format of muse displays has been 
improved, so they now include both hexadecimal and ASCII values. 

Extended memory addressing 

The Apple IIGS Monitor supports all the features of the new $5C8l6 
microprocessor, including 16-bii registers and 24-bit addresses. 
The command syntax now Includes two hexadecimal digits of bin k 
address (delimited by a slash) so the Monitor can address any bank. 



Tho Monitor 
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Pro Dos a ond ProDOS 14 or& 

the disk operating systems thcr 
run on the Apple l>ss. See 
Chapter 3 Tor deserip^ons of 
ProDOS & and ProDOS Id. 



Mini-assembler and disassembler 

All models of I he Apple II have some version of the disassembler, 
and alt but the early modcEs of the Apple lie have a mini-assembler, 

The Apple JIGS has both. They are enhanced to support the 6"5016 
microprocessor's new instructions and long addresses, an. I they 
support both native and emulation mode. 

The mini-assembler and disassembler are special features of the 
Monitor. The mini assembler provides a means of developing and 

debugging a pmgram or routine in a very simple form of assembly 
language. 

When you invoke the mini-assembler, the prompt character 
changes to an exclamation point (!) and the Monitor accepts 
6"5C8l6 instructions in the form 

address .■ opcode operands 

The address field and the colon are optional ^ you omit them to 
enter consecutive instructions. The minL-us.'iemhler does not 
maintain a symbol table, but it does recognize all the standard 
instructinn mnemonics, and it calculates relative addresses. H 
recognizes a preceding number sign (*) as signifying an immediate 
operand, You use the letters X and Y, set off by commas, for 
indexing, and you type indirect addresses inside parentheses. 

To stop the miniassembler, you type a null line by pressing the 
Return key. 

Unlike the mini -assembler, which lakes over the user interface and 

accepts inputs from the user, the disassembler is just the Monitor's 
List command. It lists the contents of memory, one screenful at a 
time, converting op codes into mnemonics and relative addresses 
into absolute addresses. 

Both the mini -assembler and the disassembler can handle all 91 of 
the 65C8l6's instructions and all 24 addressing modes (a total of 256" 
op codes), In addition, the disassembler properly expands 
operating-system calts to ProDOS 8 and ProDOS 1G, show ing 
command numbcis and parameter-list pointers on separate lines. 
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Monitor I/O firmware 

4 Apple H: This melton describes the Monitor I/O roy lines, 
which are functionally the same on the Apple lies as on Lhc 
Apple 1 3c and Apple lie. If you are Alreadv familiar with the 
Monitor I/O routines, you might as well skip ahead to the 
section "Interrupt Support. 1 * 

The Monitor accepts inputs from the keyboard and displays 
information on the screen. To dm these tasks, it has its own I/O 
routines. Every Apple II contain* seme version of the Monitor, so It 
also contains these built-in I/O routines. Because they are always 
available, many application programs use them for keyboard input 
and text display output. 



Standard I/O links 

The Monitor I/O routines include standard input and output 
routines that are used by lhc operating system, by device driven 
and by applications. The standard I/O routines pass control on to 
internal I/O routines by way of two local ions in RAM called the I/O 
links. The I/O links contain the addresses, of whatever I/O routines 
are in control at the time. 

In an Apple II running without an operating system, the I/O Jinks 

normally contain the addresses of the standard Internal I/O 
routines. An operating system typically replaces the link addresses 
with the addresses nf its Own t/O routines, and in turn calls the 
internal I/O routines. 

There are two sets of internal I/O routines: one set thai exists In all 
Apple It's, even the earliest, and another set that exists only on 
Apple II a s that support eO-colymn displays. The routines in the 
earlier set are Key In and COutl- the 80-column roudncs are 
C3Keyln and C^COutt, (Keyin Is pronounced key in and COutl is 
pronounced Cvut one. C3Key In and C3COutl are pronounced 
€ three key in a nd C three C out one.} 



Monitor I/O firmware 
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ThE I/O links are two-byte addresses at locations $0036 and 3003& in 
bank 500; sec Figure 4^1- The link at location $0036 is the output 
link it is named CSW, for character (output} switch, It holds the 
address of the subroutine that handles single-character output 
When you issue a PRfrn command from Applesoft or an 
n Control -P from the Monitor, the firmware changes the address 
in this link to the first address in the ROM space allocated to slot or 
]i::n number n. Subsequent calls to the output link are thus 
transferred to the firmware associated with that slot or port. When 
you issue a pfcto or a Control -P. the firmware reptaces the slot 
ROM address at CSW with the address of the internal output routine. 

The link at location 30038 is the input link; it as named KSW„ for 
keyboard (input) switch Like the output link, it normally hotds the 
starting address of a standard routine — in this case, the routine far 
single-character input When you issue an IN#n command from 
Applesoft or an n Control-K from the Monitor, the firmware 
changes the address in this link to the first address in the ROM space 
allocated 10 sSoi or port number n. Subsequent calls to the Input link 
are thus transferred to the firmware associated with that slot or pon. 
When you issue an IN#0 or a Control-*^ the firmware replaces 
the slot ROM address at KSW with the address of the internal input 
routine. 



$003*? 


K5WH 


KSW (input) 


$0D3e 


KSWL 


SO037 


CSWH 


CSW {output? 


SQ03& 


CSWL 


Figura 4-1 
Standard I/O links 
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Fof nr.ofg information obour the 
rtnrvdord input and output 
■ou1in.es. refer to fho manual 
Appie tfss Firmware ftar&?6nc0. 



Input routines 

The Monitor firmware includes two different subroutines for reading 
from the keyboard: RdKey tpronounced read key} and GetLn 
{pronounced get tine). The RdKey routine provides input of a single 
character by calling the current character input rouUnc, that is, the 
routine whose address is stored in the input link at K5W, Thai 
routine Is normally either Key In or C3Kcy[n, which accepts one 
character from ihc keyboard. The Kevin routine displays a cursor at 
the current cursor position h waits unnl ■■• tih' me presses a key r ihen 
puts the ASCII value of thai key into the accumulaiar and passes 
control back 10 the calling program, 

The GetLn routine provides input for entire lines by making 
repeated calls to the input routine until i\ gets a carriage return. 
Gciln starts by displaying a prompt: a character that indicates that 
the program is waiting for input. Different programs can have 
different prompt characters simply by storing the desired chant etc r 
at a specified location in RAM. As the user types keys, the GetLn 
routine stores the ASCII values into successive locations in the input 
buffer in memory locations SOZ0O-5O2FF. The GetLn routine also 
supports some simple screen editing and control features. 



Output routine 

The standard output routine is named COut (pronounced Cout, for 

character output). El calls the current character output routine, that 
is, l Me routine whose address is stored in the output link CSW. The 
character output routine is normally cither COutl or C3COutl, 
which sends one character lo the display, advances the cursor 

T iittart, and scrolls the display if necessary. Both character output 

routines restrict their use of the display to an active area called the 
lest window, which is determined by four values stored in RA.M; left 
margin, width, top line, and bottom line. 



Other routines 

The Monitor firmware also contains other useful routines for 
dealing with the keyboard and display. like the standard I/O 
routines described above, they carry out low4evel functions 
appropriate for the operation of the Monitor. 



Monitor I/O flrmwore 
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foe mwo Information about me 
firmware I/O routines, t$iw to 
tfio manual Appte JUGS flmwors 
Gete/encs. 



Important 



The firmware routines include functions such as 

□ clearing all or specific parts of the screen 

a clearing the screen and putting the cursor in the upper-left 
corner 

z drawing colored points and lines in Ln-Ees graphics 

Z gelling the color of a specified location on the Lo-Res screen 

~ printing out the value in the accumulator in hexadecimal 



Interrupt support 

"ITie firmware includes interrupt support for the full range of 
interrupts possible on the Apple HGS. As in the Apple lie and the 
enhanced Apple lie, the firmware on the Apple lies makes 
interrupt-driven programs possible. Interrupts work well with 
ProDOS Cany version) and Pascal Ore vision 1.2 or higher); DOS 3 3 
doesn't support interrupts. 

The goal of the interrupt handler is to support interrupts in any 
memory configuration. U saves the machine's slate at the time of 
the interrupt, and puts the machine into a standard memory 
configuration before passing control to your program's interrupt 
handler. 

whenever an interrupt occurs and interrupts are enabled, the 
hardware uses an address called an interrupt vector, stored in ROM, 
to transfer control to the first pan of the interrupt handler, also in 
ROM. The systems interrupt handler supports interrupts in any 
memory configuration. It saves the machine's state at the time of 
the interrupt, and puis the machine into a standard memory 
configuration before passing control to your program s interrupt 
handler. 



The interrupt vectors are stored In system ROM (bank $FF. 
locations SFFEE-SFFFF), and so h a short Interrupt service 
routine (bank SFF P locations SC071-SC07F). For Interrupts to 
wa/k with programs running In bonks SDQ and SOT . I/O 
shadowing and Eanguage-card rnapplrvg must be on. Table 4-1 Is 
a surnmary of Ine types oT interrupts the firmware rocognEzes. 
For more Information about Interrupts, ptease see the manual 
Appi& tiss Fkmwar& Reference. 
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Tabl*4 1 

Ust of Apple Ngs interrupts 




Typ» oi Interrupt 


Coui* of Interrupt 


Program BKK ins miction 


A break instruction in a program 


IRQ la short Tor interrupt requeiJ. 
wtiich ii a signal Inpul to the 
1 microprocessor requeuing an 
htwrupt. Dspnencfifip on the 
rfpfo of a flag in ths pr^coi&or's 
ro^us register. |t con olther 
■tfGCt to on IRQ pr Ignore ft. 


Peripheral card IRQ 

VBL 

Video scan line 

Mouse 


Request from a peripheral card 
Vortical-blanking time occurred 
Scan-line time occurred 
Button, movement, or V3L 




AppleTaLk Network 


Address recognition or error 




Timer for AppleTalk 


Occurs every 0,26667 seconds, to 
trigger event processing by 
ApplcTalk 




Keyboard 


Key was pressed 




Serial input on port 1 


Transmitter empty K data received, or 
error 




Serial input on port 2 


Transmitter empty, daia received, or 
error 




Ensoniq DOC 


An oscillator completed a waveform 
table 




Clock chip 


Occurs every second 




Apple DeskTop Bus 


A DeskTop Bus device requires 
service 




Cold'Slart reset. 


Power up r or Control-Apple- Reset 
keys pressed 




Warm-start reset 


Hcripheral'Card reset, or 
Contiot-ttesct keys pressed 
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The Apple IIgs 
Toolbox 
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One of the Important differences between the Apple IIGS personal 
computer and earher models of the Apple H is that, like the 
Macintosh, the Apple IIGS has a built-in toolbox with routines that 

can be calied by applications. The Apple JIGS Toolbox serves two 
purposes: It makes developing new applications easier, and it 
supports the desktop user interface. 
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What is th© Apple IIGS Toolbox? 

The Apple IIGS Toolbox is a collection of useful routines that can be 
cadlcd by application programs. The toolbox routines are a 
permanent part of the system; they are available to application 
programs without the need to link libraries to applications, 

The tootbo* routines have many uses. There are routines that 
support the new hardware features of the Apple IIGS, such as Super 
Ili-Rcs graphics and the Digital Oscillator Chip (POQ. Other 
routine?, su|i]win 1 1 ■-- - sl^ktop user interface, which uses mouse 

operations in menus and windows, 

The Toolbox routines are arranged in logical groups called toolsets, 
managers, or simply toots. Each individual routine that can be 
called by an application is a tool call. For example, the routines thai 
support the Super Hi-Res graphics display are in a tool set named 
QuickDraw 11, and PatntPoty Is a typical call in that tool set. 

Not all of the tools are resident in ROM; some of them are loaded 
from disk and reside in RAM. The calling mechanism is the same 
regardless of where in memory a tool resides. A tool can even be in 
RAM in one version of the toolbox and in ROM in another version^ 
the application, will run the same in cither case, 

Developers are not restricted to the tool sets provided by Apple; 
they can create tool sets of their own 'Ilic Tool Locator provides a 
way io Switch back and forth between the Apple IIGS tool sets and the 
application's own tools. For information about creating a tool set. 
please read the manual Appte IIGS Toolbox Reference, Volume 1, 






Apple IIGS Toolbox compared 
with Macintosh 

Most of the routines in the Apple IIGS Toolbox are similar to 
routines in the Macintosh Toolbox. In facu the Apple lies 
designers started with the most important Macintosh routines and 
tried to copy them as closely as possible, considering the 
differences between the machines, Much of the work a typical event- 
driven application does to support the user interface can be 
accomplished using the Apple JIGS Toolbox. 



Similarities 

People familiar with the Macintosh Toolbox will find that many of 
the routines fn the Apple TIGS Toolbox are similar to their 
Macintosh counterparts. Table 5-1 is a list of those Apple IIGS tool 
sets and the similar tool sets in the Macintosh. 

Table 5-1 

Macintosh counterparts for Apple IIgs tool sot: 

Apple Etas tool *«t Macintosh loci i*l 



QuickDraw II 

SAKE™ 

Desk Manager 

Event Manager 
thigh-level calls) 

Event Manager 
Gow-level calls) 

Menu Manager 

Window Manager 

Control Manager 

i.inc^'Jir. 
Dialog Manager 
Scrap Manager 
Print Manager 



QuickDraw 
Floating-Point Package 

Desk Manager 
Toolbox Event Manager 

Operating System 
Event Manager 

Menu Manager 

Window Manager 

Control Manager 

TextEdit 

Dialog Manager 

Scrap Manager 

Printing Manager 



Apple lies Toolbox compared with Macintosh 
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ProDOS 16 i& me disk operating 
ivsterrv tor the Apole IIGS. See 
Chaprer & tor a description. 



TneKesoureo Manager Is a 
Mocinto&h tool for editing data 
in programs without recompiling 
fhem. 



Several other tool sets in the Apple Tics Toolbox have functions 

similar to tool sets in the Macintosh, but actually work quite 
differently. For example, the Tool Locator in Apple IIGS has the 
same function as the Trap Dispatcher in the Macintosh, but it's 
actually quite different, Similarly, the Memory Manager in 
Apple IIGS has the same job as the one in the Macintosh, but deals 
with a memory space quite unlike that of the Macintosh, Other 
examples include (tie Apple litis System Loader, which is associated 
with ProDOS 1G\ and the Text Tool Set, used with the text display, a 
Apple IIGS feature that has no equivalent on the Madntosh. 



DiFferences 

While many of the routines in the Apple IIGS Toolbox are similar to 
their counterparts in the Macintush Toolbox, they are certainly not 
identical. The main reasons for the differences arc listed In 
Table 5-2 and cxplaned in the following sections. 

Table & 2 

Differences between the Apple Ites and the Macintosh 



Feature 



Apple 1 1.; s 



Maclnloih 



Display 



Microprocessor 



Color graphics and 
text 

65C&l6 k a descendant 
of (he 6502 



Memory organization 64K memory banks 



Resource Manager 
TaskMasler 

Sound tools 



Not present 

Part of Window 
Manager 

Sound Manager 



Black-and- 
white graphics 
and text 

6B0O0 



Continuous 
memory 

Pan of toolbox 

Not prcseni 

Free-Form 

Sound Player 



Displays 

The Super Hi -Res graphics display on the Apple II CS is supported 

by the QuickDraw 11 tool set, which provides many functions similar 
to those in the QuickDraw tool set on [he Macintosh— similar, but 

not identical 
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Tt-d g*p*ef fnMo of cm Image te 
ihn ratio of its wlath to lis 
hslgnt. Trte standard video 
display has a 4:3 aspect *otlo. 



One major difference is that [he Super Hi-Res display has color, 
which the Macintosh display doesn't have. Another difference is 
ihat the Super Hi-Res display is coarsen its highest resolution is 640 
x 200, compared with 512 x M2 for the display on the Macintosh. 
The aspect ratios of the pixels are also different: pixels in the 
Macintosh display are square, but pixels in The Super Iti-Res dispLay 
are tat J (aspect ratio 5-6 in 320 mode, 5: 12 in 640 mode). If your 
Macintosh application includes the dispLay dimensions as 
constants, you 1 it have to make appropriate changes to use the 
application on the Apple JIGS. 

Microprocessors 

The microprocessors used In the two machines are entirely 
different, The 65C81G used in the Apple IIOS has different 
instructions and addressing modes from those of the 66000 used in 
the Macintosh. The 65CS16 has 16-bit data registers, while the 63000 
has 32-bit registers. 



Memory ergo nidation 

Memory is organized differently on the two machines. Memory in 
the Macintosh is continuous, but memory in the Apple IIGS, though 
contiguous, is not continuous, it is divided into 64K banks, with 
parts of some banks dedicated to special lasks Csuch as display 
buffers and I/O devices). 

On the Apple IIGS, memory banks $00 and S01 axe broken up by 
several features needed for running programs written for earlier 
versions of the Apple It the display pagcs h the I/O space, and the 
language-card space. Also, them are differences in the way the 
65CS16 microprocessor handles different banks. The Memory 
Manager on the Apple IIGS has to accommodate these restrictions, 



Tool sets 

The Apple IIGS Toolbox doesn't have everything in it that the 
Macintosh Toolbox has One tool set not found on the Apple RGS is 
the Resource Manager. You en still put your program's constants 
and data structures in a separate segment, but they won't be quite as 

easy for you to change. You'll need to be aware of this difference 
when setting up the segment with the Items you might want to 
change, such as icons and menu titles. 






Appla Ites Toolbo* compored with Macintosh 



6" 



For more Information about 
programming an the Apple JIGS 
compared with the Macintosh, 
rarer to thfi Programme/ s 
fhfrodU?flon Ja ffte Apple ites. 



On the other hand,, the Apple TIGS has some tools Lhai the 
Macintosh doesn't. For example, the Window Manager on the 
Appte lies has a special call, TaskMasicr, that makes ir easier to use 
the window environment (see the section "Window Manager," later 
in this chapter). 

Another area whem the Apple HGS differs from the Macintosh is 
that of sound toots. While the Macintosh has the Free-Form Sound 
Player the Appte lies has the Sound Manager, a low-level tool for 
controlling the digital sound chip (the Ensoniq DOC). 



Suggestions for programmers 

Applications on the Apple II GS. have strong resemblances to 
applications on the Macintosh. They can have a similar desktop 
user interface, with menus and windows which the user manipulates 
by using a mouse. Programs on both machines can be event- 
driven, so their structures can be similar, with a main event loop 
and conditional branches to the parts Df the program that deal with 
each kind of event. 

To keep from being dependent on memory configuration, 
applications on the Apple IIGS use program segmentation and 
relocatable code. Unlike programs on the Macintosh, Apple lies 
programs are not normally position independent, but they can be 
relocated by the System Loader 

Programs written in higji level languages like C or Pascal on the two 
machines can be very similar. Programs or segments written in 

assembly language can also take advantage of the similarities 
between the Apple IIGS and the Macintosh, but must be rewritten 
because the machines use different microprocessors. The 
microprocessors have different architectures and addressing 

modes, so they require different assemblers. 

* Aafe. Apple s assembler for the Apple TIGS Is not like the 
EdAsm assembler for ihe Apple II- The Appte LlGS assembler 

not only has the 65C8 UJ's additional instructions,, it also uses 
different macros. For more information about the assembler, 
see Chapter 9. 






62 



Chapter 5: The Apple lies Toolbox 



Making calls to the toolbox 

Programs make calls to individual routines in the Apple UQ5 
Toolbox by means of call names. The calling mechanism depends 
on the language of the program that is making the call. Foe 
programs in assembly language a macro libra ry defines the names, 
and programs nuke calls in the fotlowing fashion: 
1 Push space for the result (if any) onio the sLack. 

2. Push the inpul parameters onto the stack. 

3. Invoke the cat! macro. 

4. Pull the result (if any) from the stack. 

Foe calls in high-level languages such as C or Pascal, there arc 
libraries that define the names of the tool calls, along with 
appropriate coding conventions for passing parameters cm the 
stack, similar to Lhe one defined above for assembly-language calls 



The tool sets 

Here arc brief descriptions of the loo! sets on the Apple NGS. For 

complete descriptions, please Defer to the manuals Apple Iks 
Toolbox Reference, Volumes t and 2. Tool sets with related 
functions are grouped together: for example, all the tools that 
support the desktop interface are together in the section "Desktop 
Tools." 



The big five 

These five tools — Tool Locator, Memory Manager, QuickDraw II, 
Event Manager, and Miscellaneous Tool Set— make up the 
foundation of the toolbox, Your program may not catl on them 
directly, but other parts of the toolbox and of the operating system 
are heavily dependent on them. 



Tool locator 

The Tool Locator provides the mechanism for dispatching tool 
calls. Thanks to the Toot Locator, tool sets can reside either in ROM 
or in RAM That makes it possible for future versions of the toolbox 
to substitute enhanced tools in RAM for tools presendy in ROM with 
no changes to application programs. 
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Developers need to use the Tool Locator only if they are adding 
their own tool sets to the toolbox; the Apple lies Toolbox 
Reference, Volume 1 , tells how to do that. 

Memory Manager 

The Memory Manager controls use of memory by application 
programs. Keeping memory use under control of the Memory 

Manager makes it possible to have co-resident applications such as 
desk accessories. "I"he System Loader calls the Memory Manager to 
request memory space for toading a program. The program has the 
option of making its own calls to the Memory Manager to request 
(allocate) additional memory, release Cdeal locate) memory, or 
find out how much memory is currently available. 

Quick Draw II 

The standard display for the desktop environment on the 
Apple IIGS is the new color Super Hi -Res graphics. To support the 
graphics display. Apple lies firmware includes a set of graphics 
routines named QuickDraw 11. 

The graphics routines in QuickDraw tl arc based on a subset of the 
Macintosh QuickDraw routines. They include calls for changing the 
graphics environment and for drawing simple objects called 
primitive objects. The primitive objects QuickDraw II handles are 

□ lines 

p rectangles 

D regions 

a polygons 

G ovals 

a rounded rectangles 

a arcs of circles 

- pixel images 

a text characters and strings 

QuickDraw II iz important not only to graphics applications, but to 
alt applications that use the desktop Interface, because it includes 
the text-drawing calls applications use for putting text into display 
windows on the desktop, 

In addition to the drawing routines, QuickDraw IF also has routines 

for performing calculations on different graphics objects; for 
e* ample, to determine whether a specified point is inside a 
particular rectangle. 
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Besides all ihat h QuickDraw II also includes calls for defining the 
global graphics environment (for example, setting color tables) 

and for defining portable graphics environments, called GruJFQrt& t 
so that an application can keep track of several different graphics 
activities on different parts of the screen (or even in memory thai 
isn'i being displayed). 

Event Manager 

An event-d riven application carries oul its operations in response 
to mouse and keyboard actions by the user. The application 
program Is organized around a main Loop thai contains a call [o the 
Event Manager followed bv a series of conditional statements. 
These conditional statements determine the program's Operations 
on the basis of the information returned by the Event Manager For 
example, pressing the mouse button generates an event, which the 
Event Manager reports the next lime around the loop. The Event 
Manager also reports events within the application lhat may require 
a response. For example, changing one window may cause another 
window to become visible and need to be redrawn. 

The Event Manager on the Apple IJGS was designed to be as much 
like the event managers on the Macintosh as possible. Although it is 
a single tool set, it has two kinds of calls, high-level: and the low- 
level, thai resemble calls to the Macintosh Toolbox Event Manager 
and Operating System Event Manager The Apple IIGS Event 
Manager detects low-level events, such as presses of the mouse 
button, and stores ihem in an event queue- High-level calls retrieve 
events from the event queue and report events thai aren't kept In the 
queue, such as window events. 

Miscellaneous Tool Set 

Tool calls in the Miscellaneous Tool Set include routines to perform 

such tasks as 

□ accessing battery backed-up foAM 

P reading and selling the built-in clock 

□ accessing peripheral cards 

D changing the firmware inicrrupl vectors 

D installing and deleting tasks m the heanbeat interrupt queue 

□ enabling or disabling some interrupt sources 

□ accessing ihe mouse directly 
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Desktop tools 

These tools — Menu Manager, Window Manager, Control Manager. 
LineEdit, Dialog Manager, and Desk Manager — support the 
standard desktop interface. 



Menu Manager 

An application program sets up menus and defines ihe menu bar by 
calling the Menu Manager. When the user gives a command, either 
from the menu using the mouse or by typing a command key, the 
application calls the Menu Manager lo find oul which command 
it is. 



Window Manager 

Information displayed by an application program appears in 
windows. The application makes calls to the Window Manager to 
create windows, activate ihcm 4 move ihem, change their sizes, and 
close them. The Window Manager keeps track of overlapping. 
windows and posts events so the application can redraw wind ows 
that are newt/ uncovered. Also h when the application detects the 
eveni thai happened when the user pressed ihe mouse button, the 
application calls the Window Manager to find out whether the 
cursor was in the menu bar or a desk accessory or, if it was in ihe 
window, which part of the window it was in- 
One of the calls in the Window Manager is TaskMaster, which is a 
kind of extended gct-cvcnt call. A TaskMaster call can handle many 
of ihe events that are likely to happen in a window environment, 
such as mouse clicks in the control regions, without passing control 
back to the application. By using Taskmaster calls, a programmer 
can gel an application up and running quickly and still take 
advantage of the features of the desktop user interface 



Control Manager 

A control is an object on the screen lhat the user clicks with the 
rnuuse 10 cause an acuon or change a setting, Conuols include 
objects such as buttons, check boxes, and scroll bars. The 
application creates and responds to controls by means of calls to 
the Control Manager, 
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When the application has found out from the Window Manager ihat 
the user pressed ihe mouse button in a window thai contains 
controls, it then calls the Control Manager to find carry out 
appropriate actions, such as 

D displaying or hiding a contfol 

3 monitoring the user's operation of a control 

a reading or changing the setting of a control 

a changing ihe size, location, or appearance of a control 

UneEdir 

Application programs accept text typed by the user and perform 
standard editing functions on the text by means of calls to UncEdit. 
Els functions are 

u inserting and deleting te*t 

□ using the mouse to select text 

□ cutting and pasting text 

LineEdit provides basic text-display formatting such as word 
wraparound. It handles only a line at a iime 1 unlike the text editor in 
the Macintosh Toolbox, which is a multi-tine editor. 



Dialog Manager 

The Dialog Manager is a tool for handling dialog boxes and alerts in 
a way that is consistent wjih the Apple User Interface Guidelines, 

Wheq an application needs more information from the user about a 
comma nd 1 it displays a dialog box. To alert the user in case of an 
error or a potentially dangerous situation, the application can 
display a box with a message, cause a sound from the speaker, or 
both. To create and display dialog boxes, to alert the user by a 
sound, and lo find out the users responses to the boxes and the 
sounds, the application calls the Dialog Manager. 



Desk Manager 

The Desk Manager handles desk accessories, which are small co- 
resident application programs such as calculators, calendars, and 
the Like. The user can invoke a desk accessory while an application is 
running, use the desk accessory' for some task, then continue the 
application as if nothing had happened. 
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There are two kinds of desk accessories on the Apple flcs: classic 

desk accessories that can run either in the AppEe IIGS desktop 
environment or with non-Apple lies applications CI ike 
AppleWorks), and new desk accessories that run only in the 
Apple IICS desktop environ menu The Desk Manager checks to see 
which environment it is in and makes sure that a desk accessory can 
run in that environment before calling in 

Two classic desk accessories are built in: the Control Panel that is 
used lo change the machine configuration and set the Lime and 
date, and the Alternate Display Mode thai Is needed for 

applications that use both La-Res graphics pages. 



Mathematical tools 

Tno. toolbox has two different ways of handling numeric operations: 
the SANE numerics, which provide comprehensive floating-point 
arithmetic, and the Integer Math Tool Set, which are used by the 
other 100I sets to perform integer arithmetic. 



Flooring -poinr numerics (SANE) 

The Standard Apple Numerics Environment CSANE) is a 
scrupulously-conforming., extended-precision implementation of 
IEEE standard floating-point arithmetic, The Apple lies SAKE tool 
set was derived from the 6502 assembly language SANE software, 
and his the same functions as the Macintosh SANK packages. 
Features of the numeric tool set include 

D fEEE types single (32-biO, double (64-bit), and extended (SO-bSO 

d 64-bit type fo* exact fixed-point computations, such as in 

accounting 

D basic floating-point operations ( + - * + V rem ) 
c Comparisons 

2 conversions between binary and decimal or floating-point and 

integer 

a scanning and formatting for ASCII numeric strings 

a logarithms, exponentials, and trigonometric functions 

Q compound interest and annuity functions for financial 
computations 

□ random number generator 

D functions for managing the floating-point environment 

G other functions required or recommended by the IEEE standard 
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Integer Math Tool Set 

The integer math loot set IndudCii: several routines Tor working on 
da la of types integer, long integer, fixed* mdjrac (that is. fractional 
part). The function* of this too] set include multiplication, division, 
square root, some trigonometric Functions, rounding, and 
conversions between data types. 



Print Manager 

Ihere is one loot set For dealing with printing: the Print Manager, 
Refer to the Apple JIGS Toolbox Reference, Volume 2, for 
information. 



Specialized tools 

The tool sets described in this section take care of specialized tasks, 

Sound Monpger 

The Sound Manager controls both the single-bit sound hardware 
and the Digital Oscillator Chip CDOQ It includes two sets of 
routines: standard tool calls Ccalled by way of the Tool locator) and 
low-level calls (called by way of a Jump table) designed for faster 
access. 

By making tool calls to the Sound Manager, an application can 

□ send sound data tp and from the sound RAM 

□ control the volume of the sound 

D siart and stop the sound from a particular sound generator in the 
DOC 

D get the status of any or all generators in the DOC 

p set up the sound interrupt handler 

z get the address of the jump tabfe for accessing the low-level 
routines 

Using the low-level sound routines, an application can 

□ read or write any register in the DOC 

□ read or write any location in the sound RAM 
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one or more previous colls to It 
are pending wstnout Invalidating 
any previous co'ls 



DeskTop Bus Tool Set 

The Apple DeskTop Bus (ADB) Tod Set provides a 
communications and control interface between your application 
and the ADB microcontroller that operates the DeskTop Bus, 
besides the bus commands, the ADB Tool Set includes calls used by 
diagnostic routines and the Control Panel. 

The ADB Tool Set includes specific commands for the keyboard 
and the mouse. For other devices, applications need driver 
routines that set up the devices and handle their operation. Ihe 
setup routines identify the different devices on the bus and may 
even change bus addresses and data handlers for them. 

"{"he ADD Tool Set includes calls For polling all the devices on the 
bus. For repeated use of a slngjc device, theie is a polling call that 
always starts with the last device that was active. The application can 
use whichever polling method is appropriate to control the priority 

of devices on the bus. 



Scheduler 

Much of the system code in the Apple IICS is not reentrant. The 
Scheduler makes it possible to delay the execution of tasks that 
require non-reentrant system code whenever that code is already in 
use. Non- reentrant resources indicate that they are in use by 
modifying a Flag called the Busy word. The Scheduler maintains a 
queue of processes waiting to use non-ieenuant resources. By 
keeping track of the Busy word, the Scheduler determines when 10 
activate the next process in the queue. 

Text Tool Set 

like the other computers in the Apple 11 familty, the Apple IICS has 
a video display mode for text only To use the text-display firmware 
as earlier Apple II programs do, programs have to be running in 
emulation mode in bank $00. The Text Tool Set, along with the 
enhanced video output routines in the firmware, makes it possible 
for applications on Hie Apple IICS to use the text display wiLhout 
switching environments and moving id bank 500. 
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Standard Fil* Operations Tool Set 

The Standard File Operations Tool Set provides the standard user 
interface for specifying a file to be opened or saved by an 

application. When the user selects Open or Save in the File menu, 
the application calls die appropriate standard file operation, which 
opens a dialog dok, displays the files in the current volume, and 
handles user selection of files or options, such as selecting a 
different drive or ejecting a disk. 



Scrap Manager 

The Scrap Manager includes routines and data types that make it 
possible to cut and paste teat or graphics between two applications, 

between an application and a desk accessory, or between two desk 
accessories. From (he user's point of view, the data being cue or 
pasted resides Jn the Clipboard. 

The Scrip Manager keeps the data being cut and pasted in a block of 

memory called the desk scrap. The Scrap Manager can store it on 
disk if there isn't enough room for it in memory, The type of data 
being transferred is different for di flerent applications, The Scrap 
Manager provides for different data types and provides some 
control over the amount of information that is retained when the 
scrap Is transferred. 
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Figure 4-1 

Hypothetical Apple I 
using the Mega II 



The basic idea behind the Apple IIGS architecture is to make a more 
powerful Apple IT — one ihiL can run programs designed for earlier 
models of the Apple II and also support more sophisticated 
programs. The Apple 1LGS achieves this contradictory-sounding 
goal by a combination of hardware and firmware — including a new 
microprocessor, expanded memory,, improved video displays, 
and a new sound generator— thai still has the ability to operate as an 
Apple IT, 

The microprocessor used in the Appie 11S5 is the 65OI6, a new l&- 
bii design based on the 6502 microprocessor used in other 
Apple If s. The 65CS1tj has two major features; 
□ li can operate either as a lf>bit processor or as an B-bil 6502. 
D It can address to up to t6 megabytes of memory. 

The ability of the 65C816 to execute 6502 instructions, make* it 

possible for the Apple IIGS to run programs designed to run on 
6502-based models of Lhe Apple II. The tiSCBlfc large address 
space makes it possible for the Apple IIG5 to have more memory 
than 6502-based Apple 11 's. 



The design process 

This section describes the design of the Apple IIGS as a process of 
expansion, starting with the Apple XL Understanding a little about 
the way the Apple lies, evolved will help you understand the 
relationships between its new features and its old features. 



Starting point: the Apple II 

To understand how lhe Apple lies personal computer incorporates 
the features of the Apple II, first consider the standard Apple IT. 
Figure 6-1 is a simplified bfock diagram showing how an Apple II 
might be designed around Apple's Mega II integrated circuit. The 
Mega II is a custom large-scale integrated circuit that incorporates 
most of the timing and control circuits of the standard Apple II- It 
addresses 128K of RAM organized as 64K main and auxiliary banks. 
The Mega U also provides the standard Apple II video display 
modes, both text (4Q-column and 8f>column) and graphics (Lo- 
Res, Hl'Rcs, and Double Hi- Res). The slots indicated in Figure 6-1 
arc like the ones on the Apple lie- the ports are like the ones on the 
Apple lie. 
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Adding a foster processor 

Now suppose thai we replace the CPU with a new, Taster 
microprocessor and add faster RAM and ROM and a new video 
display generator. Figure 6*2 is a simplified diagram of the result. 
Shading identifies the parts that provide the new features^ generally 
speaking, ihc parts on the unshaded side provide ihe standard 
Apple II features. Ihe CPU is now the o"5CS16 on the shaded side; It 
operates in 6502 emulation mode when executing standard Apple II 
programs. 
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Figure 6-2 

New hard wo re odded to the Apple II 

The new CPU runs faster than the normal Appte II processor — 
2.8 MHz, compared with the normal 1 MHz. To manage the 
disparate speeds, the new system has a custom integrated circuit, 
the Fast Processor Interface OTQ. that supports the faster memory 
for the new CPU and control CPU access to the slower Mega EI side. 
Besides controlling the fast RAM and ROM, the FPI also controls 
expansion RAM, up to eight megabytes of additional fast RAM. 
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The shaded side of Figure £-2 also includes the Video Graphics 
Controller (VGC). This integrated circuit provides a new video 
display, the Super Hi-Res graphics display. The new graphics 
display produces clear high- resolution color graphics on an RGB 
color monitor. 

Figure 6-2 is misleading in one important respecL it Implies that 
programs designed for the standard Apple It run In the part of RAM 
controlled by the Mega U k which is not the casc^ such programs 
actually run in the 12SK of fast RAM on the shaded side of the 
diagram. The next section explains that aspect of memory on the 
Apple riG5. 



Memory on the Apple llGS 

The description of the Apple HCS as merely an Apple II with a faster 
processor falls far short of the whole story. As Figure 6-2 shows, 
adding the faster processor requires adding faster memory. Besides 
that, one of the reasons for ihe new processor is not just that It runs 
faster, but that it can address more memory, making possible a 
significant increase in the amount of memory on the Apple Uns P 
The following sections tell how the larger, faster memory is 
implemented. 






Faster memory 

The Apple lies is capable of executing instructions almost three 
times as fast as a standard Apple II. That speed can be used in two 
different ways: to obtain faster execution of standard Apple 11 
programs, and to enable new programs to take Eu.ll advantage of the 

65C816 processor. 

It's important to realise that application programs— even programs 
designed for the standard Appte tt — do not run in the IZfiK of RAM 
controlled by the Mega II. That part of RAM always runs at the 
standard 1 MI la speed, because it contains the I/O slots and the 
display pages. The t/O slots must be able to run Disk II controller 
cards and other peripheral -card firmware with timing loops 
designed to run at the standard t MI la speed. The display pages 
have to be synchronised with the video hardware, which also runs 
at 1 MHz. The I/O and display features arc allocated to memory In 
high-numbered banks to keep the low-numbered banks available for 
fast RAM for running application programs. 
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The Fast Processor Interface (FPD handles Addressing and memory 
refresh for all of the RAM except [he 128K controlled by the Mega II. 
The FP1 also handles ROM addressing, rnstruction execution in 

those areas of memory runs at the rate of 2.6 MHz, Whenever the 
CPU needs to mad or write in the Mega U RAiM (banks $E0 and 
SED, the FPI synchronizes the CPU timing to match the 
Mega ITs 1 MHz clock 

The user always has the option of using the 1 MHz speed for an 
application. (CPU speed is an option in the Control Panel) Note 
that the program is still executing in the fast pan of RAM, but the FPI 

is operating at the standard speed. 



Memory shadowing 

For Apple II programs to fun in memory banks $QQ and $QI, those 
banks must have the same features as the memory in a 128 K 
Apple He or an Apple He. That means they must include the 
language-card mapping in the area above SDOOO, ihc I/O spaces 
starting at $CQGO h and the display buffers for the standard Apple TI 
displays. Here is a puzzle: To make the low-numbered memory 
banks available as fast memory, the Apple IIGS designers put the 
hardware for the I/O and the displays into memory banks $EQ 
and 5 El, Programs designed Tor the Apple il run In banks $00 and 
$01 Cas main and auxiliary memory), and don't address any other 
banks. How can such programs operate t/O and displays? 

■*■ Note; All I/O in an Apple 11 is memory mapped. Cercarn 
memory locations are attached to I/O devices, and I/O 
operations are just memory read and write instructions. 

The designers of the Apple IIGS devised a technique so that 
programs running In the fast part of memory (banks $00 to $7F) can 
operate the I/O and display features implemented in the slow pan 

of memory (hanks $E0 and $E1>. The technique is called memory 
shadowing, and hem's how it works. When shadowing is selected for 
a specific area, the Apple IIGS hardware executes any instruction 
that writes into that area of bank $00 or $01 by writing both theie 
and into the same address in bank $W or $Hl. Because the memory 
in banks SEO and $E1 is synchronized to the video hardware, the 
instruction must execute at the slow speed 



Memory oo the Apple tics 
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Display shadowing works a little differently from I/O shadowing. 

Por WO shadowing, both reading and writing are slowed down, For 
display shadowing, the slowdown affects only instructions that tvrite 
in the shadowed arcas^ the CPU still read* from the display areas of 

banks 500 and $01 ai the faster speed. 

So that existing application programs will run on the Apple IIGS, the 
operating system turns shadowing on whenever It loads an old-style 
application. 



Memory maps 

The memory maps in Figures 6-3 and 6-4 show the RAM and HOM 
areas indicated in Figures 6-1 and 6-2. The 12BK of fast RAM on the 
shaded side of Figure 6-2 corresponds to memory banks 500 and 
SOI; the (fast) RAM on the memory expansion card begins in bank 
502 and can extend as high as bank $7F. 

The slow RAM controlled by the Mega II corresponds to memory 
banks 5 HO and $E1. Those banks contain the video display pages 
and the memory locations allocated to the I/O expansion sloes. In 

addition, the built-in firmware also uses RAM in banks JEO and $EL 

To give application programs full access to the low-numbered 
banks, the Apple 11 OS designee allocated system memory in the 
high-numbered banks. The system ROM is in banks $Fli and $FF 
System KQM includes Applesoft, the Monitor, built-in port 
firmware, and the ROM portion of the toolbox. Banks $F0 through 
SFD are allocated to ROM on a memory expansion card K which is 
used for additional system firmware and for applications stored as 
ROM Disk files 



Memory for standard Apple II programs 

The feature of the Apple llr,s ittat makes it possible for it to run 
standard Apple II programs is the implementation of the standard 
12SK Apple It memory map in the 65C8l6's expanded memory 
space. This is done by configuring two of the 64K memory banks to 
look like the RAM in a 128K Apple fle: banks $00 and $01, as shown 
in Figure 6^3. 
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Memory map for standard Apple N programs 
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To make two memory banks cm ibe Apple HGS worts like the main 
2nd auxiliary memory in an Apple lie, those banks must have 
memory shadowing in effect for I/O spaces and for the standard 
Apple U text and graphics display pages, CThe Super ITi-Rcs 
graphics display is not a standard Apple II display and Is not 
normally used with standard Apple II programs) 

When the user boots up a standard Apple II program on the 
Apple lies, the firmware sets up memory banks $00 and $01 as main 
and auxiliary memory, wrth language -card spaces, display buffers 
and the I/O space ai hex ICxxx The firmware also sets the direct ' 
page frcro page) and stack locations to $0000 and $0100 in bank 
500. 

Programs written for 6 bit Apple Us don I use RAM outside ihe 
main and auxiliary banks. To make additional memory useful with 
such programs, ProDOS B uses the additional memory as a mass^ 
storage volume named /RAMS, 

Memory few new programs 

Mew application programs written lo use the full capabilities of the 
Apple lias don't have I he restrictions of programs written for the 
standard Apple 13 New programs can occupy memory in banks SOD 
and SOt, parts of banks $H0 and $EI t and all of the expansion RAM 
in banks $02 through |7F. The applications can call the Memory 
Manager to obtain additional memory in those areas. 
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Memory mop for new Apple ties programs 



Figure 6-4 shows the areas of memory available to applications 
written specifically for the Apple IIGS. Notice that banks 500 and 
S01 sliU have shadowing in I/O space and text Page 1. Those areas 
must be shadowed for proper operation of interrupts and 
peripheral cards. Also notice that the expansion RAM (banks S02 
through $7F, if present} ls available as contiguous memory space. 

♦ A reminder; To ensure compatibility with desk accessories and 

other co- resident routines, Apple IEGS applications uhat need 
additional memory must request it From the Memory Manager 
Olae System Loader calls the Memory Manager to obtain 
memory space needed for loading initial program segments.) 
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The program enutnmment is lhc combination of all of the aspects 
of the machine thai affect the operation of the program Many of 
the things that make up the program environment are fined, for 
example, the fact that memory is addressed as bytes, or the Fact that 
all I/O is memory mapped. This chapter describes those aspects of 
the program environment thai can be changed from one 
application to another, 



Environment options 

Programs running on ihe Apple IIGS personal computer will usually 
be of two basic types- programs that can also run on B-bil 

Apple H's, and programs that can run only on the Apple IIGS, 
While the environments for those two program types are the ones 
used mosi often, they are not the only ones possible, and there is 
no single master switch for changing from one to the other. "Hie 
program environment has many aspects, and programs can change 
any of them independently of the others, 

$ Note: There are two operating systems for the Apple lies, 

corresponding to the two types of programs; ProDOS B for 8-bit 
programs,, and ProDOS 16 for l6*bit programs. Chapter fi 
induces brief descriptions of the opeiaiting systems. 

The aspects of the environment that a program can change are 
D the microprocessor mode, register sizes, and values in bank 

registers 
a the locations and sizes of the stack and direct page 
a lhc execution speed 

a operation of the language card and t/O spaces 
D lhc display memory spaces, including choice of displays and 

shadowing 

The following sections describe those aspects of the program 
environment. 



Microprocessor options 

Several of the conditions that are difTererit in the different 
environments are attributes of the microprocessor. Those include 
lhc microprocessor mode, the register sizes, the bank rftglstez 
values, and the locations and sizes of the slack and direct page. 
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Microprocessor modes 

The 65C816 microprocessor can operate in two different modes; 
native mode, with alJ of its oew features, and 6502 emulation mode, 
for running programs written for 8-bit Apple II s. 

Hie 65C8J6 has three flags named e, m, and x thai programs use to 
control its operating modes You put [he 65CB16 into 6502 
emulation mode by setting the e flag to ]. When you do that, the 
G5CS16 automatically makes the accumulator and index registers 8 
biLs wide. It also makes the stack only 256 bytes long like ihc slack in 
the 6502. In emulation mode, the direct page and the stack ate 
automatically at locations 50000 and $0100 in bank $00. 

Setting the c flag to puts the 65C816 into native mode. In native 
mode, a program can make the stack and direct page larger than Z5£ 
bytes and can put them anywhere in memory bank S00. 

Register sizes 

In. the 65C&I6 processor's native mode, the widths of the 
accumulator and index registers are controlled by the m and x flags. 
tn the Apple lies, both the m and jt Hags are normally set to zero, 
making the registers 16 bits wide. Applications running in native 
mode can change either of those flags to make the accumulator or 
the index registers only 8 bits wide f but there is normally no reason 
for an application to do so r even though some system routines work 
Lhat way. 

When running applications written for it, the Apple ECS normally 
operates with 1 6-bit accumulator and Index registers. When running 
8-bit Apple 11 programs, the system switches the processor to 
emulation mode, which automatically forces the register widths to 8 
bits, On emulation mode, the m and x flags have no effect) 

Bonk register values 

Applications written specifically For the Apple JIGS can use any 
banks in memory by setting the program bank register and data 
bank register appropriately. When running fl-bit Apple II 
programs, the system firmware sets both the program bank and the 
data bank to bank $00. 
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Stack and direct page 

For programs written for standard Apple Il's, the stack and direct 
page must be in their proper 6502 locations, and the stack must be 
256 bytes long. For programs written specifically for the Apple 11GS, 
the si*e oF the stack and the locations of the stack and direct page 
within bank 500 are at the discretion of the application. 

When running the 65C816 in native mode k you can locate the stac 1 : 

anywhere between 50600 and SBFFF in bank $00, If you switch to 
emulation mode, the processor automatically sets the upper half of 
the stack pointer to $01. when you then switch back to native mode, 
the upper half of the stack pointer remains set to S01, and your 
original stack pointer Is lost- 

Whcn you switch to emulation m,odc h you have to save your nativc- 
modc stack painter temporarily, then set the stack pointer to the 
emulation-mode stack and push the native-mode stack pointer onto 
the emulation-mode stack. After doing lhat, you switch the 
processor to emulation mode. To switch back from emulation 
mode to native mode, you reverse the process: First switch to full 
native modc^ then pull the native -mode pointer off the emulation- 
mode stack and transfer the 16-bit value to the suck pointer. 

** \'ote- Never use the main and auxiliary switches in native mode; 
doing so prevents the firmware tools from working properly. 
Whcn setting up the change from native to emulation mode, 
you have to use the emulation-mode stack in main memory, 
that is, bank 500. 



You must always have interrupts disablea while you ore 
manipulating the stack pointer. 



Execution speeds 

The microprocessor in the Apple JIGS can opcraTe at either of two 
clock speeds: the standard Apple H speed, 1 Ml 1st, and the faster 
speed of 2,8 MHz. For programs running in RAM, a few clock cycles 
are used for refreshing RAM,, reducing the fast speed to an effective 
value of about 23 MHfc. System firmware^ running in ROM, runs at 
the full 2 8 MHz 
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There art three different ways of changing the operating speed 
First, the user can use ihe Control Pane] to set the speed, Second, if 
a slot has a Disk II controller card tn it, the firmware switches to the 
1 MHz speed whenever that slot is active, so that the disk controller 
wilt work eonedJv. Third, programs can change the dock speed by 
changing the high bit of the Configuration register, a control 
reg liter in location $C03G, 



Language-card and J/O spaces 

Shadowing of the WO and language-card spaces is controlled by the 
IOLC O/O and language card) bit in the Shadow register, a control 
register located at SC035 in bank 5E0: see Table 7-1. The IOLC bit is 
normally set to zero, enabling I/O in the $CxX& space and mapping 
the 4K of RAM that would ordinarily occupy that space into a 
second bank of RAM in the SDxxx space, as shown in Figure 7-1 
That configuration of the high l6K of RAM is called the language 
card, a Tier the first Apple II product that provided RAM memory in 
those locations. 
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Figure 7-1 

Memory map of language-ecu d fcAM 



Implications for interrupt 

Part of the interrupt routines are in ROM In the \/0 space at $G07x. 
For that ROM code to operate, I/O must remain enabled in the 
iCxxx part of bank 500 and the high lfiK of RAM must stay mapped 
as a language card; that is, the IOLC bit of the Shadow register must 
be zero. If a program changes the IOLC bit so it can use RAM In the 
SCxxx space, the intermpt routines won't work IQLC shadowing 
must be left on even by programs running in nadve mode, which 
don't otherwise use the language-card mapping. 
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Standard Apple II display memory 

An application running on. the Apple lies can use any of the display 
modes available on 128K Apple II's or the new Super Lli-Res 
display. Of course, a typical application will use only one or two 
display modes, so it can disable the rest. 

Applications- written for E-bit Apple II's run in banks 500 and $01, 
but the hardware for video displays uses memory In banks $H0 and 
$El. For those applications, the Firm wane sets shadowing on for 
those display spaces, so that when the application writes into a 
display page in bank $00 or 50 1, the hardware also writes to the 
same location in bank Sfc'O or $El. 

The program-selection routine in the Apple IIGS automatically sets 
the display shadowing appropriately for the operating system that it 
is loading; on for DOS 3.3, UCSD Pascal, and ProDOS 8, and off 
for ProDOS 36. When the startup routine sets display shadowing 
on, it sets shadowing for all standard display pages. An application 
can turn off shadowing of individual display pages by setting 
individual bits in the Shadow register, as shown in Table 7- 1 

Table 7- \ 

The Shoctow register (location SC035) 



Bit 



Function O ■ InhlbifJ 



7 (reserved — read undefined, must write zero) 

6 IOLC (I/O and language car<3Q operation 

5 {[reserved — read undefined, must write zero) 

A Auxiliary Hi -Res Pages 1 and 2 

3 Super Mi-Res graphics space 

2 Hi-Res graphics Page 2 

] Hi-Res graphics Page 1 

Text Pages J and IX 
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Super Hi-Res display memory 

The Super Hi -Res display is a new graphics display that has several 
advantages over ihc standard Apple 1 1 displays. While its two modes 
have resolution* thai are only slightly higher lhan the resolutions of 
standard Hi- Res and Double HI-Hes, there is no interference 
between adjacent colors, so Super Hi-Res displays look much 
clearer than Hi-Res or Doubte Hi-Res. It is also easier to program* 
because it maps entire bytes onto the screen, instead of just seven 
bits, and its memory map is linear and continuous, Even though 
Super Hi-Res does cost a little more, occupying MK of RAH you'll 
probably want to use it anyway, because it is supported by the 
desktop tools. 



Shadowing for Super Hi- Re* display 

The Sujier Hi-Res display uses locations $4000 through 3BFFF in 
bank SE1 and is normally not shadowed. An application tan turn 
shadowing on and ofTfor the Super Hi- Res display by means of the 
Shadow register When shadowing is on for the Super Hi-Hes 
display, applications can write to that display space in bank $01 
(auxiliary memory). 

+ A reminder: Applications that use the QuickDraw 1 1 routines in 

the Apple lies Toolbox for their displays should have display 
shadowing off. The QuickDraw 11 routines write direcdy to the 

Super Hi-Res display space in bank $E1, so no shadowing is 
needed. 



Linear memory map 

To make life easier Tor the graphics programmer, there is an option 
to make The addresses in the Super Hi-Res display memory map 
onto the display in a simple linear fashion. Bit 6 of the New-Video 
register controls the linear mapping option (1 to enable, to 
inhibit). Of course, applications that use QuickDraw II don't have to 
set the video control bits; QuickDraw U takes care of that itself. 

^ Note: The linear-mapping option is not compatible with 
standard Mi-Res and Doubte Hi-Rcs graphics. 
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■fr Apple f£ Memory mapping in the standard display modes is of 
a byzantine complexity. First, adjacent rows of dots or 
characters on the screen are not stored in adjacent areas of 
memory, making it necessary for display routines to calculate 
the smarting location for each row, AJso, Hi-Res graphics has the 
added handicap of 7-bit bytes; that is, only seven bits of each 
byte are displayed. This makes it harder for display routines to 
calculate the address of a byte that corresponds to a position on 
the screen. Double Hi- Res is further burdened with the 
necessity to alternate between memory banks when addressing 
adjacent locations on the screen. By using linear mapping, 
Super Hi 'Res display routines avoid these problems. 

Table 7-2 

Now-Video register (tocation SCQ20) 



All 



Function 



7 

6 

5 

1-4 





Enables Super Hi-Res graphics display 

Enables Linear mapping for Super HE-Rcs graphics 

Inhibits color In standard Apple II displays 

(reserved) 

Enables bank latch (used by system) 



Mixing environments 

Despite the profound di (Terences between the different program 
environments on the Apple IlcS H many operating features are 

similar. It is therefore possible to enhance existing Apple II 
programs so that they can take advantage of AppEc IIGS features such 
as desk accessories and program tools. 

Specifically, the tootbox routines are accessible not only from 
application programs written specifically for the Apple 11^5, but 
also from programs running in 65*02 emulation mode. It Is therefore 
possible to modify existing 6^02 programs, adding toolbox calls so 
the programs can use The new features and the desktop user 
interface. CThe toot sets themselves run in native mode; 
applications running in emulation mode must switch to native 
mode to make tool calls, and switch back to emulation mode 
afterward.) 
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II is even possible to make a hybrid program than runs on either a 
6502-based Apple II or on a Apple fIGS, by having ihe program 
check Do see thai it Is running on a Apple UGS before it makes any 
toolbox calls. 

A similar kind of compatibility is available with desk accessories, 
which are accessible from standard Appie II programs running with 
ProDOS £5 or from Apple IIGS programs running with ProDOS 16- 
Thcrc are two kinds of desk accessories; classic desk accessories, 
which can run in any Apple I1GS environment and new style desk 
accessories, which can run only under ProDOS 1 6. Each desk 
accessory has a flag that determines which versions of ProDOS it 
can run with. En the software hierarchy, the Desk Manager ss below 
ProDOS. When the user invokes a desk accessory, the Desk Manager 
detects which version of ProDOS ii is running under and checks to 
see that the requested desk accessory can run wsih that version. 



Environment summary 

The simplest distinction between program environments on the 
Apple IIG5 is between the one used for running programs written for 
8-bit Apple It's and the one used for programs written specifically 
for the Apple JIGS. Tabic 7-3 ts a list of the conditions making up 
these two program environments. While it is possible for 
applications to set up other combinations, these two program 
environments are the only ones the firmware and tools support. 



Tab i» 7-3 

Apple Elss program environment 



Fiaiur* 



A -bit Appta N program* 



Appl* Has program* 



CPU mode 
Accumulator size 
Index register sire 
Execution speed 
Direct -page address 
Stack address 

Slack size 



Emulation £c=l) 
S biis Cc-D' 
S bits Ce-1) 1 
1MHz or 2.6 MHz 

£0000 in bank £00 
$0100 in bank $Q0 

256 bytes 



Native Ce=0) 

16 bits On-0) 

16 bits 0c-0) 

23 MHz 

Any page in bank $00 

Any page from SQ8QQ to 5BP0O in 
bank $00 

Any siae up to SB7FF 
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ToWs 7-3 {continued} 

Appfe lies, program environments 



Feahj-e 



9-WI Appl* II program! 



Appl* iigs program* 



Language-card spaces 
in banks $00 and $01 

Shadowing of I/O spaces 
in banks $00 and $01 

Shadowing of text 
Pages 1 and IX 

Shadowing of Hi-Rcs 
graphics pages 

Default display 

Mapping, of Super HI -Res 
memory addresses 

RAM available to 
application 



Use of expansion RAM 

by application 

Operating system 

*ln cimikUan mode fc-]>, Lhc 



Yes 
Yes 
Yes 
Yes 
Text 



Yes 
Yes 
Yes 
No 
Super I [i-Res 



Normal, for Apple n standard Linear^ for Super Hi- Res display 

displays 

Banks $00 and S01 (plus expansion Banks $00 and 501, expansion 

RAM and parts of banks SE0 and RAM, and parts of banks SEG 

$B1 , if modified to mn on the and $E1 
Apple lies) 

As RAM Disk Cor via Memory As RAM Disk or via Memory 

Manager, if modified to run on die Manager 
Apple IIGS) 



ProDOS S, DOS 3 3. or UCSD 

Pascal 



ProDOS 16 
rn arid x Hags arc always effectively equal id 1. 
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Since their inception, the AppEe II computers have had built -Ln 
firmware to support application programs, and the Apple U GS 
personal computer continues and extends that tradition. In the 
past, some applications programmers have bypassed the firmware, 
taking direct control oJ" the system hardware. This chapter describes 
some of the ways this Is done and some of the problems that arise. 



Levels of program operation 

You can think of the different levels of program operation on an 
Apple n as a hierarchy, with a hardware Layer at the bottom, 
firmware and operating-system Layers in the middle, and the 
application at the lop. Figure B-l illustrates this idea. CThe 
hierarchy in Figure 8-1 is a hierarchy of command 
levels — generally speakings higher4evel components call on lower^ 
level ones,) 
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Levels of program operation 



















Piogiam control of the hardware 

From the beginning, the Apple [I has been an open machine. Not 
only has it been possible to extend the hardware by means of 

peripheral cards in expansion slots, bat programs have been able 
to take control of the hardware independentiy of the built-in 
firmware. 
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Whenever the firmware seemed loo slow, application prog rammers 
have taken the option of controlling [he hardware themselves. As 
later models of Apple II have incorporated more firmware the 
need for applications to do it all for themselves has diminished. 
The Apple Uc& has built-in program support far beyond thai 
available on earlier models of the Apple II. Even so, it is still 
possible for a program to bypass the firmware and control the 
hardware directly, 

As Figure 9-1 shows H all of the levels except (he lowest one are 
software— even firmware fa only software that fa permanently 
resident, As far as the hardware is concerned, one program is much 
like another, regardless of its origin. 

Every part of the Apple lies, including the 65CEI6" microprocessor, 
control registers In the custom ICs,. the display buffers, and ihe I/O 
devices, Es accessible to the application program. Many of the 
computer's function* J re controlled by soft switches^ which are 
memory locations permanently assigned to some hardware 
function, The soft switches are described In the Apple Has 
Hardware Reference. 

'[he phrase 'programming on the hare metar expresses the attitude 
of programmers who control the hardware themselves. That 

method has the advantage that everything is done the way the 
programmer wants it. The obvious disadvantage is that the 
programmer has, to do a lot more work, but a more important one is 
the increased likelihood that the resulting program will be 
incompatible either with other programs or with future versions of 
the computer. 

In order to run older programs that were written with this approach, 
the Apple II GS continues the Apple II tradition of hardware 
accessibility at the lowest level That makes it possible to program 
the Apple IIGS "on the bare metal* It does not make it advisable. 



Using the Apple II firmware 

The next level up from t\vc bare metal Is the built-in firmware. In the 
earliest Apple II, this was little more than primitive I/O routines for 
handling input from the keyboard and formatting text output to the 
display screen Gn <f0 columns only, of course} The latest morjcl 
Apple He and Apple lie include more powerful firmware to handle 
the EO-column display, the mouse, serial I/O, and disk drives, 
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Because there have been many changes from model to model, it 
has generally been easier to maintain compatibility with 
application programs that make use of the firmware interface, as 
compared with programs that control the hardware themselves. 
There is now a strong argument in favor of using the firmware, even 
when ihe programmer is dissatisfied with its performance, just to 
minimize incompatibilities. 

A similar argument applies to disk operations. In the past, some 
applications have set up their own disk hie formats and included 
their own versions of DOS Apple's new ProDOS for the Apple IIGS 
Is fast and powerful;, the cost oFgosng your own way is now quite high 
compared with the advantages of staying compatible. 



Using the Apple Mgs Toolbox 

The concept of a program tooloox is new to the Apple II family: The 
Apple IlGS Is the first Apple U to have one. If you ate an 
experienced Apple II developer, even if you have striven to 
maintain maximum compatibility by using only the firmware 
Interfaces that Apple has provided, you may find the toolbox to be 
a new way of programming. From that point of view, the Macintosh 
developer may have an easier time of it While the toolbox is not 
the same as the one on the Macintosh, it is similar in concept, and 
many of it* functions are the same. 

The advantages of using the Apple lies Toolbox are many. Not only 
do the tools do a lot of the work that the application would otherwise 
have to do, but the machine itself is set up to use the toots. 



Apple IIGS operating systems 

There are three kinds of operating systems that can run on the 

Apple IIGS: 

□ earlier systems such as DOS 33. ProDOS 1.0, and UCSD Pascal, 
which run the same way on the Apple IIGS as on other models of 
the Apple il 

n ProDOS 8, which runs on all current Apple IFs and supports 
many of the new features of the Apple lies 

□ the new ProDOS for the Apple IIGS, ProDOS 16, which supports; 
all of the new features but runs only on the Apple IIGS 
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The new ProDOS for ihe Apple IIGS rakes advantage of the l6-bit 
"instructions and hrgfi,. continuous memory space on the 
Apple IIGS P making it unable 10 run on 64K and 128K machines To 
make it easy to distinguish between ihe two kinds of ProDOS, the 
ProDOS thai runs on &bit Apple H's is called PruDOSSand ihe 
ProDOS for the Appfe HGS is called ProDOS 36. 

ProDOS \6 Is functionally similar to fl-bit versions of ProDOS: r but 
Li does not work (he same way, so programs that run under an 3-bit 
ProDOS will not run under ProDOS 16 without suitable 
modiJj cat ions. The latest version of 8-bit ProDOS, ProDOS E< 
supports B-bii programs running on the AppEc tlOS, The System 
Loader automatically loads the appropriate version of ProDOS, 
depending on ihe type of starrup file it finds on the boot disk. 
Tahle 6-1 is a summary of the differences between ProDOS 8 and 
ProDOS 16. 

TabbA-1 

ProDOS a and ProDOS To compared 



Fvatuir* 



ProDOS a 



ProDOS 1 6 



Microprocessor mode 
Minimum memory 
Maximum memory 
iMempry management 

RAM Disk 

Memory pointer size 
System call instruction 
System file suffix 
System file type 



650Z emulation 
64K 
128K 

Bit map In global 
page 

Connected 
2 bytes 

J5R into bank SOO 
SYS 
IFF 



65C816 native mode 

8.25 megabytes 

Memory Manager 

Disconnected 
4 bytes 

JSL into bank 5E1 
SVS16 
SH3 



Just remember that ProDOS 8 is for 8-bit Apple n applications 
running on the Apple HGS, and ProDOS 16 is for Apple JIGS 

applications. 

♦ Note, Even though ProDOS S and ProDOS lo an? different, 
they both use the same disk formats and file structures. Either 
one can read 3 file written by the other, except that ProDOS B 
won't start up from the startup files (type $B3> used for 
ProDOS 16, and ProDOS 1 6 wont start up from the system files 
Gype $FF) or binary files (type 5%) used For ProDOS 8. 
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Apple MG5 ProDOS 16 Paforence 
Includas inform otlon about the 
System Loader. 



The System Loader 

The Apple OGS Toolbox includes the System Loader, a system 
program that makes Putt use of the large memory and the 

standardized load modules on the Apple lies. The System Loader, 
working in conjunction with ProDOS 16 and the Memory Manager, 
loads and relocates program segments, Programs can be compiled 
and linked as individual segments, some of which can be loaded 
dynamically, as needed, 

Load segments can be cither static or dynamic Static segments 
remain in memory all during program execution The System 
Loader loads all of a program's static segments when it first loads 
the program. 

The System Loader doesn't load dynamic segments until they are 
called for during program execution. The program can request 

specific segments try catling the System Loader, or the loader can 
use the segment jump table, which is a special segment seE up by the 
linker to deal with references across segment boundaries. 



Apple II compatibility 

One of the most Important features of the Apple 1TG& is its ability to 
run standard Apple II programs. The Apple liGS incorporates alE 
the features of the Apple lie and most a( the features of the 

Apple He, including ihr ability to Support either 5.25-inch or 35- 
inch disk drives connected to its disk port 



Running existing programs 

Users can boot standard Apple II program disks on the Apple IIGS 
and run most programs without modification. Such programs will 
not use any of the new features of the Apple EIGS except Its ability to 
run 2.5 times as fast. The programs will be running in 6502 
emulation mode and the memory space available to them will be 
configured just like the 12BK of RAM in an Apple lie. 
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Users can invoke the Control Panel desk accessory to change the 
I/O slot assignments lo use with ihcir Apple I] programs, They can 

nho change the teat display colors and the operating speed, For 
example, they'll probably want lo run their business programs at 
the fast speed, but they may warn to slow down to normal speed for 
games. 



Enhancing existing programs 

Even for programs running in emulation mode, all of die new 
features of the Apple ttCS are available. The only trouble is thai 
programs written Tor earlier Apple lis don't include routines that 
make use of the new features. As a developer, you can modify your 
programs and add such routines while maintaining compatibility 
with older models of Apple II. Modified programs can check to see 
what kind of Apple II they are running on and take advantage of the 
new features if they arc running on a Apple IIGS. 

^ Afare: To find Out what kind of Apple II they are running on, 
programs can read the ID bytes at locations 5FB133, SFBGQ, 

and JFRRF in ROM. Assembly-language programs can execute 
a JSR (jump to subroutine) to location SFE1F in ROM, then 
branch on the state of the carry hit: U will be one for any &-bit 
Apple II and zero for the Apple IIGS. For more information. 
refer to the Apple HGS Firmware Reference. 

OF course, if you're going to modify an existing Apple II program, 
some of the new features make more sense than others. For 
example, changing (he program to add routines that use the new 16- 
bit instructions would require a lot of work — work lhat would 
probahty be better spent on writing a new version of the program, 
On the other hand, modifying a program so it could use the built-in 
tools might be worthwhile. The decision should be based on 
whether the resulting program could still (It in memory on an 
Apple He or Apple lie. If it couldn't, It would be better to make a 
new version of the program just for the Apple llr-^. 

Another way to make an application run on either an 8-bit Apple J] 
or on a Apple 1ICS is to make a new version that runs only on the 
Apple IIGS and pm both versions on a single disk. The appropriate 
version would run, depending on whai kind of machine the disk was 
booted on. Ihe cold-start routine on the Apple IIGS looks for a 
system file wilh the suffix .5YS1G and loads ProDOS 16 if it is 
present; an 0-bit Apple II boots with a SYS file and gets FroDOS 8. 
Refer to the Apple IIGS ProDOS 16 Reference for more 
information. 
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The development environment is the software that you use for 
developing programs on the Apple ncs. The development 
environment includes two kinds of programsj first, the language 
compilers and assemblers., and second, programs that all 
developers use, regardless of which language They arc using Each 
compiler or assembler has its own manual, The programs that are 
used with any of the programming languages are described in the 
Apple HGS Programmer's Workshop Referent®. 

Several features of the Apple DOS help you with program 
development. First of all, there is a standard format for object files, 
regardless of their source. Then there are the linker and the System 
Loader that, together with standard load files, make el possible to 
create modular programs with relocatable segments and to 
combine segments written in different source languages. The 
languages available on the Apple IIGS include assembly language 
and C, To provide a consistent, programming environment, there is 
the Apple lies Programmer's Workshop (APW). The workshop 
includes the operating shell for controlling the language compilers, 
along with the program editor, the debugger, the linker,, and utility 
programs, 



Program modularity 

The basis of the Apple II G5 development environment is the 
standard file formats. The standard formats make it possible to use 
many different programming languages on the App]e lies. Aiong 

with the System Loader, they also make possible program 
segmentation, with relocatable segments that can be loaded 
dynamically during program execution. 

Creating a program is a multi-step process. First, the program is 
written En the form of one or more source files. Compilers and 
assemblers process the source files and produoe object files. The 
tinker then lakes the program ohject files, along with any 
appropriate library object files, and produces one or more load 
files. El Is the load Flics Lhal gel loaded into memory when the 
program Es cxecuied. 
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Object files and load files 

Assemblers and compilers produce object files. The linker 
combines object segments from one or more object Hies and 
produces a load file. Separate segments in object files can be 
combined into a single segment by [he linker. Thai makes it 
possible lo write the program as separate pans and recompile only 
the affected pan whenever you make a change. 

In addition lo ihe program object files, there can be library files 
containing general -purpose segments used by several programs. 
The linker can search the library and extract the segments needed 
by the program. 

Each load file consists a( one or more segments, which can be static 

or dynamic. Static segments- must remain En memory while the 
program is running, but dynamic segments can be loaded and 
unloaded individually as they are needed. 

Program segments can also be relocatable, that is h capable of being 
loaded anywhere in memory. The actual fe location is carried out at 
run time by the System Loader. Each load segment contains both 
the program code and a relocation dictionary, which the System 
Loader uses to recalculate addresses when it loads relocatable 
segments. The load file formal was designed to make dynamic 
loading as Fast as possible. 



Programming languages 

The Apple IIGS development environment docs not restrict 
developers to a single programming language. You can use any 
programming language for which there is a compiler that produces 
object files in the Apple lies object module format. The Languages 
available from Apple include assembly language and C 



Assembler 

The AFw" Assembler executes under the control of the APW Shell. 
The assembler supports the Apple ttGS standard object file format 
and relocatable segments. 



Progf cjmrning languages 
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A maQio ni»nTbl*r can eornb'ne 
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Conditional msB^nbly =s tne 

ofcirrtY to define macros or other 
pieces or code sucri that they 
PHemblo dltferenfry under 
etffBrent ccn,diiioAi. 



The APW Assembler is a full-featured macro assembler. It 
supports the instruction sets and addressing modes of the 65GB 1 6 
microprocessor. The assembler includes 

□ an extensive set of assembler directives 

D macros and conditional assembly 

o support for segments, which can be either code or data 

u partial assembly, so that changes do not require reassembly of 
the entire program 

D Support for library files that the linker searches in case of 
unresolved references 

*■ jVofe The APW Assembler is not a version of Apple's ProDQS 
Assembler Tools CEdAsm). 



C compiler 

The high- level language in the Apple TIGS Programmer's Workshop 
is C. Programs written in C can easily include sections written in 

assembly language and in Pascal. 

APW C is similar to Macintosh UVjrksbop C The Apple UGS 
Interface Ubrary provides an interface to the Apple IIGS Toolbox 
that is functionally similar to the Macintosh Interface Libraries. 

There are a Tew differences from Macintosh C, such as 

□ The size of int variables is t6 bits. 

n The format of the pascal declaration is different. 

a Function results are returned in a global variable, rather than the 
suck. 

c Register variables are not available 

The Apple 11QS Programmer's Workshop C Reference includes 

definitions of the C language and of the standard C library and the 
Apple IIGS Interface Library. It describes the diJIercnces between 
Apple IIGS C and a standard C: the Berkeley 42 BSD VAX 
implementation of the Portable C Compiler. 
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Other compilers 

There can be a Apple IIGS compiler for almas: any programming 
language- all the compiler has to do is produce object files 
compatible wJjJi ihe Apple IIGS object file format. Languages for 
which compilers could be written include Pascal, BA£lC> Fortran, 
Logo, Cobol, and Lisp, 



Apple IIGS Programmer's Workshop 

The Apple IIGS Programmers Workshop (APW) Ls a set of programs 
that Apple provides to make it easier to develop applications for the 
Apple UCS. The programs in the programmer's workshop are 
D shell 
d editor 
□ linker 
d debugger 
G utilities 

These programs are all described in the manual Apple UQS 
Programmer's Workshop Reference. 



Shell 

The APW Shell provides the user interface that enables you to 
execute other APW programs and io perform various housekeeping 
functions such as copying fiEes. You type In commands in the old- 
fashioned way, 

The shell also acts as an extension to ProDOS 16, providing 
additional support [unctions For programs such as compilers, 
assemblers, and linker running under the shell. Those Functions 
include 

□ parameter passing between programs and the shell 
p reading and setting the language type of a source file 
d getting rile names by using wildcards 

□ passing control to other system programs 

m moving^ copying, and deleting files and subdirectories 
D renaming files 



Apple lies Programmer'* Workshop 
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D changing prefixes 

D Listing files and directories 

D changing the ProDOS file type of a file 

The shell supports programmable command or Exec Hies that can 
be used to execute any number of shell commands The Exec files 
can include parameter passing and conditional execution 
statements, The shell also supports redirection of input arid output 
and pipelining of APW programs. 



Editor 

The APW Editor is a text editor for use with the APW Assembler and 
compilers. To use the editor, you invoke it from the shell. If you 
select a pre existing file for editing, the editor is automatically set to 
the language of that fife- Otherwise, ihe editor is set to the East 
language used or the last language selected with a shell command. 
You can also use ihe editor to create Exec files. 



Linker 

The APW Linker reads object files created by the APW Assembler or 
by the APW C compiler and generates load files. For relocatable 
code, the linker resolves external references and creates relocation 
dictionaries Because the assembler and compiler create object 
files that conform to the same format, the linker can link together 
object modules created by any combination of APW languages. 

Normally, you call ihe linker by a command to the shell that lets you 
specify a limited number of linker options. You specify parameters 
for segmentation and printing in the source code itself- 

For advanced programmers who need more flexibility than the link 

command provides, the linker has a command language called 

LitikEd You can use Link Ed commands to perform such functions 

as 

n extracting segments from object files 

□ opening and closing output files 

□ creating static or dynamic segments 
D searching libraries 

□ controlling printing by the linker 
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Debugger 

The APW Debugger enables you to trace program execution one 

instruction i: a time r>r run full speed and slop at a breakpoint Each 
time the program stops, the debugger displays a disassembly of the 
code, die contents of a specified area of RAM, and the contents of 
the microprocessor's registers, stack, and direct page 

The debugger can switch between its own display and the display of 
the program under test. 



Utilities 

The programmers workshop Includes several programs that 
perform functions that cannot be handled by the built-in shell 
commands. These programs are called utilities, and they include 

□ Crunch" compresses object modules after partial assemblies or 

compilations 
g rnit: initialises a disk 

□ MacGen: generates 3 macro Hie 
D MakcLib: generates a library file 

□ DumpObj: lists all routines in an object module or load module 

Some of the utility programs require no input from the user other 
than the name; those programs am treated like any other shell 
command and are referred to as external commands. 






Apple JIGS Programmer's Wontshop 
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Appendix A 

Roadmap to the Apple llGS 
Technical Manuals 



The Apple llCS personal computer has many advanced features. 
making it more complex than earlier models of the Apple II. To 
describe it fully, Apple has produced a suite of technical manuals, 
Depending on the way you intend to use the Apple IIG5, you may 
need to refer to a select few of the manuals, Or you may need to refer 
to most of them. 

The technical manuals are listed In Table A-1, Figure A-l is a 
diagram showing the relationships among the different manuals. 



Table A-1 

The Apple lies technical manuals 






Li -o 



Subjecl 



Technical Introduction to the Apple lies 

Apple IICS Hardware Reference 

Apple HGS Firmware Reference 

I Programmer's Introduction to the Apple ms 

Apple lies Toolbox Reference, Volume 1 

Apple HGS Toolbox Reference, Volume 2 

Apple lias I'rogrammer's Workshop Reference 

Apple JIGS Programmer's Workshop Assembler Reference* 

Apple IIGS Programmer's Workshop C Reference* 

ProDOS 8 Reference 

Apple lias ProDOS 16 Reference 

Human Interface Guidelines 

Apple Numerics Manual 

There 14 3. pocket reference fur each of these 
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What the Apple HGS is 
Machine internals— hardware 
Machine internals— firmware 
Concepts and a sample program 
How the tools work and some toolbox 
specifications 

More toolbox specifications 
The development environment 
Using the APW Assembler 
Using C on the Apple HGS 
ProDOS for Apple IE programs 
ProDOS and loader for Apple IIGS 
Guidelines for the desktop interface 
Numerics for all Apple computers 




To start rinding put 
about me Apple |! -S3 



To leotn hpw 

Iho AppJp II eg works 



to itari learning 

to program fhe Apple it g 



To use she Toolbox 



To use The atevetapmerir 
environment 



p operate on riles 



iO US& C ■ 



Id use 

assembly language 



Appte ir-s-s Program f 
Workshop Assembler Reference 



J Pockel Reference 



Figure A-l 

Roadmap to fhe technical marmots 

Appendix A. Roadrnap to Irhe Apple lies Technical Manual* 
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event such pg a click or the 
mouse button. 



Introductory manuals 

These books arc introductory manuals for developer computer 
enthusiasm, and other Apple IIGS owners who need technical 
information, As EnLroductory manuals h their purpose is lo help the 
technical reader understand the features of the Apple lies, 
particularly the features that are different from other Apple 
computers, Having read the introductory manuals, the reader wilt 
refer 10 specific reference manuals for details about a particular 
aspect of the Apple IIGS. 



The technical introduction 

The Technical Introduction to the Apple HGS is the first book in the 
suite of technical manuals about the Apple lies. It describes all 
aspects nf the Apple IIGS, including its features and general design, 
the program environments, the toolbox, and the development 
environment. 

Where the Apple UGS Owner's Guide is an introduction from the 
point of view of the user, the Technical Introduction describes the 
Apple I[GS from the point of view of the program. In other words, it 
describes the things the programmer has to consider while 
designing a program, such as the operating features the program 
uses and the environment in which the program runs. 



The programmer's introduction 

When yau start writing program^ that use the Apple IIGS user 
interface {with windows, menus, and the mouse), the 
Ihogmmmer's Introduction to the Apple Ilea provides the 
concepts and guidelines you need, k is not a complete course in 
programming, only a starting point for programmers writing 
applications for the Apple litis. It introduces the routines in the 
Apple IIGS Toolbox and the program environment they run under. 
It includes a sample event-driven program that demonstrates 
how a program uses the toolbox and the operating system. 
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Machine reference manuals 

There are two reference manuals for the machine itself:, the 
Apple IIGS Hardware Reference and the Apple IIGS firmware 
Reference. These books contain detailed specifications for people 
who want to know exactly what's inside the machine. 



The hardware reference manual 

The Apple IIGS Hardware Reference is required reading for 
hardware developers, and it will a Esq be of interest to anyone else 
who wants to know how the machine works. Information for 
developers includes the mechanical and electrical specifications of 
all connectors, both internal and external. Information of general 
interest includes descriptions of the Internal hardware, which 
provide a better understanding of the machine's features. 



The firmware reference manual 

The Apple IIGS Firmware Reference describes the programs and 

subroutines that arc stored in the machines read-only memory 
CttGM), with two significant exceptions: Applesoft BASIC and the 
toolbox, which have their own manuals. The Firmware Reference 
includes information about interrupt routines and low-level I/O 
subroutines for the serial ports, the disk port, and for the DeskTop 
Bus interface, which controls the keyboard and the mouse The 
Firmware Reference also describes the Monitor, a low-level 
programming and debugging aid for assembly-language programs. 



The toolbox manuals 

Like the Macintosh^ the Apple lies has a built in toolbox. The 
Apple IIGS Toolbox Reference, Volume 1, inirod-uccs concepts and 
terminology and tells how to use some of the tools. It also tells how 
to write and install your own tool set. The Apple Has Toolbox 
Reference, Volume 2, contains information about the rest of the 
tools. 



Tbe Toolbox manuals 
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Of course, you dont have to use the toolbox at all. If you only want 
to write simple programs thaL don't use the mouse h or windows, or 
menu*, or other parts of the desktop user interlace, then you can 
get aEong without the toolbox. I-lowever, if you are developing an 
application thai uses the desktop interface, or if you want to use the 
Super Hi-Res graphics display, you'll find the toolbox to be 
indispensable. 



The Programmer's Workshop manual 

The development environment on the Apple JIGS is the Apple HC-5 
Programmer's Workshop (APW). APW is a set of programs thai 
enable developers to create and debug application programs on the 
Appte IIGS The Appte IIGS I^rogrammer's Workshop Reference 
includes information about the parts of the workshop that all 
developers will use. regardless which programming language they 
use the shell, the editor, the Linker, the debugger, and the utilities 
The manual also tells how to write other programs, such as custom 
utilities and compilers, to run under the APW Shell. 

The APW reference manual describes itie way you use the workshop 
to create an application and includes a sample program to show 
how this is done. 



Programming-Ianguage manuals 

Apple is currently providing a o5CSlG assembler and a C compiler. 
Other compilers can be used with the workshop, provided that they 
Follow the standards defined in the Apple IIGS Programmer's 
Workshop Reference. 

There is a separate reference manual for each programming 
language on the Apple IIGS. Each manual includes the 
specifications of the language and of the Apple IIGS libraries for the 
language, and describes how to write a program in thai language 
The manuals for the languages Apple provides arc lhe Appte Res 
Programmers Workshop Assembler Reference and the Apple IIGS 
Programmer's Workshop C Reference. 
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Operating-system manuals 

There are two operating Systems that run on the Apple IIGS: 
ProDOS 16 and ProDOS fi. Each operating system is described in its 
own manual: ProDOS S Reference and Apple Ifc$ ProDOS 16 
Reference. ProDOS 16 uses the full power of the Apple II GS and is 
not compatible with earlier Apple II's. The ProDOS 16 manual 
includes informanon about the System Loader, which works closely 
with ProDOS 16. If you arc writing programs for the Apple llGS f 
whether as an application programmer or a system program rner, 
you are almost certain to need the ProDOS 16 Reference. 

ProDOS 8, previously just called ProDOS:, is compatible with the 
models of Apple II that use 6-bit CPUs, As a developer of Apple LIGs 
programs, you need to use ProDOS S only if you are developing 
programs to run on 8-bit Apple II's as weH as on the Apple lies. 



All-Apple manuals 

In addition 10 ihe Apple IIGS manuals mentioned above, there are 
two manuals that apply to ail Apple computers; Human Inter/ace 
Guidelines and Apple Numerics Manual. If you develop programs 
for any Apple computer, you should know about those manuals 

The Human Interface Guidelines manual describes Apple's 
standards for (he desktop interface of programs that run on Apple 
computers. IF you are writing an application for the Apple IIGS, you 

should be familiar with the contents of this manual 

The Apple Numerics Manual is tf»e reference for the Standard 
Apple Numeric Environment CSANE), a Ml implementation of the 
IEEE standard floating-point arithmetic. The functions of the 
Apple IIGS SANE tool set match those of the Macintosh SANE 
package and of the 65G2 assembly language SANE software. If your 
application requires accurate arithmetic, youll probably wane iu 
use die SAKE routines in the Apple IIGS. The Apple HGS Toolbox 
Reference tells how to use the SANE roudnes in your programs. The 
Apple Numerics Manual is the comprehensive reference for the 
SAJS"E numerics routines. A deseripdun of the version of the SANE 
routines for the 65C816 is available through the Apple 
Programmer's and Developer's Association, administered by the 
A.P.P.L.B. cooperative in Ronton, Washington. 

* Note; The address of the Apple Programmer's and Developer's 
Association is 29Q 5W 43rd Street, Renton, WA 93055, and the 
telephone number is Quo) 251-6548. 
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Summary of Program 
Environments 



The simplest distinction between program environments on the 
Apple IIGS is between the one used for running programs written for 
8-bit Apple IPs and the one used for programs written specifically 
for the Apple IIGS. Tabic B-1 is a list of the conditions making up 
these two program environments. (This table is a duplicate of 
Table 7-3. For more information about die program environment, 
refer to Chapter 70 
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Tobfe B-l 

Appfa lies program environments 


FMtur* 


6'bll App|» || program* 


Apple rtes pr&grami 


CPU mode 


Emulation (e-1) 


Native <e=03 




Accumulator size 


6 bits Ce-D* 


16 bits (m=0) 




Index register size 


8 bits (e»l)* 


16 bits Oc-0) 




F-*ecuu"on speed 


1 MHz or 2.8 MHz 


2.8 MHz 




Pi reel-page address 


$0000 in bank 500 


Any page in bank 50G 




Slack address 


$0100 in bank £00 


Any page from $0800 to $BFO0 In 
bank $00 




Stack size 


255 bytes 


Any s&> up lo 5B7FF 




Language-card spaces 
in banks 500 and SOI 


Yes 


Yes 




Shadowing of I/O spaces 
in banks $00 and SOI 


Yes 


Yes 




Shadowing of text 
Pages 1 and IK 


Yes 


Yes 




1 Shadowing of 1 Ii-Ees 
1 graphics pages 


Yes 


No 




Default display 


Text 


Super Hi-Res 




Mapping of S u per I li-Res 

I memory addresses 


Normal, for Apple II standard 
displays 


Linear, for Super Hl-Hcs display 




1 HAM available lo 
1 application 


Banks $00 and S01 (plus expansion 
RAM and parts of banks SW and 

$E1, if modified to run on (he 

Apple lies) 


Banks $00 and S01, expansion 

RAM, and parts oi" banks $i:u and 
$E1 




J Use of expansion RAM 
, by applies lion 


As RAM Disk Cor via Memory 
Manager, if modified to run on the 
Apple IEGS) 


As RAM Disk or via Memory 
Manager 




Operating system 


PruDOS &, DOS 3.3< Or UCSD 
Pascal 


PruDOS 16 




*ln cmulaiton mode (e^l) r the 


m and k flags art always effectively equa 


I to 1. 
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Glossary 



This glossary defines technical terms used in this 
book. Boldfaced terms within a definition aie 
defined else where in the glossary. 

accumulator: "I he register in a computers central 

processor or microprocessor where most 
compu Lai tons are performed. 

AC1A: Acronym for Asynchronous 
Communications interface Adapter, a type of 

communications IC used in some Apple 
computers other than the Apple lies. Compare 
SCC. 

acronym: A word formed from the Initial letters 
of a name or phrase, such as ROM (from wad- 
only memory). 

AUCt See analng-to-dlgital converter. 

address: A number Lhat specifies the tocation of a 
single byte of memory. Addresses can be given as 
decimal integers or as hexadecimat integers. A 
frfK system has addresses ranging from to 65535 
(in decimal) or from SOQQQ to SFFFF (in 
hexadecimal} The letter xin an address stands for 
ait possible values for [bat digit. For example, 
SDxxx means ait the addresses from SDOOO 
through $DFFf\ 

American Simplified Keyboard: See Dvorak 
keyboard. 

American Standard Code for Informal Jon 
Interchange: Sec ASCII. 



analog: (adj) Varying smoothly and continuously 
over a range, rather than, changing in discrete 
jumps. For example, a conventional 12-hour clock 
face is an analog device that showi itie time of day 
by the continuously changing position of the 
clock's hands. Compare digital. 

analog RGB* A type of color video monitor lhat 
accepts separate analog signals for the red, green, 
and blue color primaries. The intensity of each 
primary can vary continuously, making possible 
many shades and tints of color. 

analog signals A signal that varies continuously 
over Lime, rather than being sent and received in 

discrete intervals. Compare digital signal. 

anal uk to-digital converter (ADO A device 
that converts quantities from analog to digital 
form. For example, computer hand controls 
convert the position of the control dial (an analog 

quantity) into a discrete number (a digital 
quantity) that changes stepwise even when the dial 
is turned smoothly. 

Apple key: A modifier key on the Apple IIGS 
keyboard, marked with both an Apple icon and a 

-f "a.wk i, lL<: kern used on the equivalent key on 
some Macintosh keyboards. The Apple key 
performs the same functions as the Open Apple 
key on the Apple He and Apple lie 
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Applesoft BASIC The Apple II dialect of the 
BASIC programming language. An interpreter for 
creating and executing Applesoft BASIC programs 
is built into the firmware of computers in the 

Apple U family, 

AppleTalk network Apple's local-area network 

for Apple II and Macintosh personal computers 
and LaserWriter and ImageWriter II printers. Like 
the Macintosh, the Apple lies has the AppleTalk 
interface built in. 

AppleTalk connector: A piece of equipment, 
consisting of a connection box, a short cable, and 
an 8-pin miniature DIN connector, that enables a 
Apple IIGS to be part of an AppleTalk network. 

Apple II: A family of computers, including the 
original Apple II, trie Apple II Plus, the Apple He, 
the Appte He, and the Apple IIGS. 

Apple He: A transportable personal computer in 
the Appte II family, with a disk drive and 80- 
column display capability buitt In. 

Appte He: A personal computer in the Apple II 
family with seven expansion slots and an auxiliary 

memory stot that allow the user to enhance the 
computer's capabilities with peripheral and 

auxiliary cards. 

Apple He 80 Column Text Cards A peripheral 

card that plugs Into the Apple Uc J s auxiliary 
memory slot and enables the computer to display 
text as either 40 or SO characters per line. 

Apple nc Extended 80-Column Text Card: A 

peripheral card that plugs into the Apple He's 
auxiUary memory slot and enables the computer 
to display text as either <1Q or 80 characters per line 
while extending the computer's memory capacity 
by 6-iK. 

Apple n Pascal: A software system for the 

Apple tl family thai leis you create and execute 
programs written in the Pascal programming 
language. Apple II Pascal was adapted by Apple 
Computer from the University of California, San 
Diego, Pascal Operating System (UCSD PascaO 



Apple II Plust A personal computer in the 
Apple II family with expansion slots that allow the 
user to enhance the computers capabilities with 
peripheral! and auxiliary Cards. 

application program: A program that enables a 
person to carry on some work, such as word 
processing, data base management, graphics, or 
telecommunication. Compare system 
program. 

ASCII Acronym For American Standard Cede 
far information Interchange, pronounced 
ASK-ee. A code in which the numbers From to 
127 stand for text characters. ASCII eocte is used 
for representing text Inside a computer and for 
transmitting te*t between computers or between a 
computer and a peripheral device. 

aspect ratio: The ratio of an image's width to its 
heigh L For exampte, a standard video display has 
an aspect ratio of 4:3. 

assembler*} A language translator that converts a 
program written in assembly language into an 
equivalent program in macblrte language- The 
opposite of a disassembler. 

assemhty language: A tow-level programming 
language in which individual machine-language 
instmctions are written in a symbolic form that's 
easier to understand than machine language itself. 
Each assembly-language instruction produces one 
machine-language instruction. See also machine 
language. 

asynchronous: Not synchronized by a mutual 

timing signal or dock. Compare syncbronnus- 

Asynchronous Communications Interface 
Adapter: See ACIA. 

auxiliary slot: The special expansion slot inside 
the Apple He used for the Apple lie BQ-Column 
Text Card or Extended 80-Column Text Card, and 
also for the RGB monitor card. The slot is 
labeled AUX. CONTNF.CTOR on the circuit board. 
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back panel; The rear surface of the computer, 
which includes the power switch, the power 
connector, and connectors Tor peripheral 

devices. 

bauds A unit of data transmission speed the 
number of discrete signal state changes per 
second. Often, but not always h equivalent to bits 
per second. Compare bJt rate, 

binary file: A file whose daw is to be interpreted 
in binary form. Machine-language programs and 

pictures are scored in binary files. 

bit: A contraction of binary digit . The smallest 
unit of information that a computer can hold The 
value of a bit Q or 0) represents 2 simple two-way 

choice, such as yes or no, on or off, positive or 
negative, something or nothing. 

bit image; A collection of bits in memory that 
have a rectilinear graphical represeniation. The 
display on the screen is a visible bit image. 

bitmaps A set of bits that represents the positions 
and states of a corresponding set of items: for 
example, dots in an image. See hit Image, 

bit rate: The speed at which bits are transmitted, 
usually expressed as tits per second, or bp$, 
Compare baud. 

block I/O derke: A type of device thai reads or 

writes information in organized groups called 
blocks, which are typically Si 2 bytes long, A disk 
drive Is a block device, 

boot Another way 10 say start up. A computer 

boots by leading a program into memory from an 
external storage medium such as a disk. Boot is 
short for bootstrap ioaa\ a term suggestive of the 
difficulty of initial loading ofloader programs into 
early computers that didn't have builUn firmware 
in ROM. 

bootstrap: See boot* 



buffer: A holding area in the computer's memory 
where information can be stored by one program 
or device and then read at a different rate by 

another- Far example, a print buffer, 

bug* An error in a program that causes it not to 
work as intended. The expression reportedly 
comes from the early days of computing when in 
itinerant moth snorted a connection and caused a 
breakdown in a room-size computer. 

bus: A group of wires or circuits that transmit 
related information frorn one part of a computer 
system to another. In a network, a line of cable 
with connectors linking devices together. A bus 
network has a beginning and an end. (lt% not in a 
closed circle or T shape.) 

buttons: The pushbutton-like images in dialog 

boxes where you click to designate, confirm, or 
cancel an action. See also mouse button, 

bytei A unit of measure of computer data or 
memory, consisting of a fiiced number of bits. 

On Apple II systems, one byte consists of eight 
bits, and a byte can have any value between and 
255. The value can represent an instruction, letter, 
number, punctuation mark, or other character 
See also kilobyte, megabyte. 

calL (v) To request the execution of a subroutine, 

function, or procedure, (n) A request From the 
keyboard or from a procedure to execute a named 
procedure. See procedure, 

carriage return t An ASCII character (decimal 13) 

that ordinarily causes a printer or display device to 
place the next character on the left margin, 

cany flag- A status bit In the microprocessor, 
used as an additional high-order bit with the 
accumulator bits in addition, subtraction, 

rotation, and shift opera dons. 

cathode- ray tube: A display device, 

central processing unit (CPU)t The part of the 
computer that performs the actual computations 
in machine language, See also microprocessor. 
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character; Any symbol that has a widely 
understood meaning and thus can convey 
information. Some characters — such as letters, 
numbers, and punctuation* — can be displayed on 
the monitor screen and printed on a printer. 

chip! See Integrated circuit 

circuit board: A board containing embedded 
circuits and an attached collection of integrated 
circuits (chips). 

clock chlpi A special chip in which parameter 
HAM and the current setting for the daie and time 
are stored. This chip is powered by a battery when 
the system is off,, thus preserving the information. 

close: To turn a window back into the icon thai 
represents it. 

CMOS: Abbreviation for complementary metal 
oxide silicon, one of several methods of making 
integrated circuits out of silicon. CMOS de vices 
are characterised by their low power 
consumption. CMOS techniques are derived from 
MOS techniques. 

code: (1> A number or symbol used to represent 
some piece of information. (23 The statements or 
instructions that make up a program. 

cold start: The process of starting up the Apple [I 
when the power is first turned on (or as if the power 
had just been turned on} by loading the operating 
system into main memory, and then loading and 
running a program. Compare boot, warm start. 

column: A vertical arrangement of graphics 
points or character positions on the display. 

command: An instruction that causes the 
computer to perform some action. A command 
can be typed from a keyboard, selected from a 
menu with a hand-operated device (such as a 
mouse), or embedded in a program, 



compiler: A language translator that converts a 
program written In a high-level programming 
language (source code) into an equivalent 

program in some lower-level language such as 
machine language (object code) for later 
execution. 

component: A part; in particular, a pan of a 
computer system. 

composite video: A video signal that includes 
both display information and the synchronization 
Cand other} signals needed to display it Also 
called M^C video. Compare RGB. 

computer; An electronic device that performs 
predefined (programmed) computations at high 
speed and with great accuracy. A machine that is 
used to store, transfer, and transform 

Information. 

computer language; See programming 
language, 

conditional assembly: A feature of an assembler 
that allows the programmer to define macros or 
other pieces of code such that the assembler 
assembles them diJTerendy under different 

conditions, 

conditional branch: A type of branch instruction 
whose execution depends on the truth of a 
condition or the value of an expression. 

configuration: (1} The total combination and 
arrangement of hardware components — C¥U t 
video display device, keyboard, and peripheral 
devices — that make up a computer system. (2) The 
software settings that allow various hardware 
components of a computer system to 
communicate with each other. 

Control key: A specific modifier key on Apple Jl- 
family keyboards that produces control characters 
when used in combination with other keys. 

Control Panel! A desk accessory that lets you 
change certain system parameters, such as speaker 
volume, display colors, and configuration of slots 

and ports. 
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control registers: Special registers that 
programs can read and write, similar to soft 
switches. The control registers are specific 
locations in the I/O space ($Cxxx) in bank $00; 
they arc accessible from bank $00 if I/O shadowing 
is on, 

Contrnl-Rcsri; A combination keystroke on 
Apple ll-family computers thai usually causes an 
Applesoft BASIC program or command to stop 
immediately. 

controller card: a peripheral card that connects 
a device such as a printer or disk drive to a 
computer's main logic board and controls the 
operation of the device 

CPU; See central processing unit. 

cursor: A symbol displayed on the screen 
marking where the user's ne*t action will take effect 
or where the next character typed from the 
keyboard will appear. 

DACi See digital- to analog converter. 

data: Information transferred to or from, 

or stored in, a computer or other mechanical 
communications or storage device, 

data bfts: The tails in a communication transfer 
that contain information. Compare start bit, 
stop bin 

data format; "I he form in which data is stored, 
manipulated, or transferred. For example^ when 
data is transmitted and received serially, it 
typically has a data format of one start bit, five to 
eight data bits, an optional parity bit, and one or 
two stop bits. 

Data Carder Detect (DCD3* A signal from a DCE 
(such as a modem) to a DTE (such AS an 
Apple II G&) indicating that a communication 
connection has been established. See Data 
Communication Equipment, Data Ter min al 
Equipment* 



Data Communication Equipment (DCE): As 
defined by the 1S-232-C standard, any device that 

LranssriiLs ar receives information. Usually this 
device is a modem. 

Data Set Ready (DSR>i a signal from a DCE to a 
DTE indicating thai me DCE has established a 
connection, See Data Communication 
Equipment* Data Terminal Equipment* 

Data Terminal Equipment (DTE); As defined 
by the R5-232-C standard, any device that 

generates or absorbs information, thus acting as 
an endpoint of a communication connection. A 
computer might serve as a DTE. 

Data Terminal Ready (DTB)2 A signal from a 

DTE to a DCE indicating a readiness to transmit or 
receive data. See Data Communication 
Equipment, Data Terminal Equipment. 

DCDs See Data Carrier Detect* 

DCEs See Data Communication Equipment 

debug; A colloquial term that means to locate and 
correct an error or the cause of a problem or 
malfunction in a computer program. See also bug, 

default: A preset response to a question or 
prompt The default is automatically used by the 

computer if the user doesn't supply a different 
response. Default values prevent a program from 

stalling or crashing If no value is supplied by the 

user. 

delete: To remove something, such as a character 
or word from a filer, or a file from a disk. 

Delete key* A key on the upper-right corner of 
the Apple He, Appic lie, and Apple J7G5 
keyboards that erases the character immediately 
preceding (to the left oQ the cursor Similar to the 

Macintosh Backspace key. 

delta guide: A description of something new in 
terms of its differences from something the reader 
already knows about. The name comes from the 
way mathematicians use the Creek letter delta ( A) 
to represent a difference. 
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desk accessories: "Mini-applications" that are 
available from the computer's menu regardless of 
which application you're using. The Control Panel 
is an example of a desk accessory, 

desktop: The visual interface between the 
computer and the user — the menu bar and the gray 

area on the screen. You can have a number of 
documents on the desktop at the same time. 

desktop environment A set of program features 
that make user interactions with an application 
resemble operations on a desktop. Commands 
appear as options in pull -down menus, and 
material being worked on appears in areas of the 
screen called windows. The user selects 
commands or other material by using the mouse 
to move a pointer around on the screen. 

desktop user interface: See desktop 
environment. 

device driven A program that manages the 
transfer of information between the computer and 

a peripheral device. 

digit* CO One of the characters through 9, used 
to express numbers in decimal form. (2) One of 
the characters used to express numbers in some 
other form, such as G and 1 in binary or through 
9 and A through F in hexadecimal, 

digital; (adj) Represented in a discrete 
Cnonconununus) form, such as numerical digits or 
integers. For example, contemporary digital 
docks show the time as a digital display feuch as 
2:57) instead of using the positions of a pair of 
hands on a clock face. Compare analog. 

Digital Oscillator Chip CDOC> an integrated 
circuit that contains 32 digital oscillators, each of 
which can generate a sound from stored digital 
waveform data. 

digital signal; A signal that is sent and received in 
discrete intervals. A signal that docs not vary 
continuously over time. Compare analog signal 



djgital-io-analog converter (DAQi A device 
that converts quantities from digital to analog 
form. 

DIN; Abbreviation for Deutsche Industrie 

Normal, a European standards organization. 

DIN connector: A type of connector with 
multiple pins inside a round outer shield. 

DIP: See dual in-line package* 

direct page: A page (256 bytes) of memory in the 

Apple IIGS that works like the itero page in a 6502 
system but can reside anywhere in bank $00, rather 

than always starting at Location $0000. Co-resident 
programs or routines can have their own direct 
pages at different locations. 

directory's A file that contains a list of the names 

and locations of other files stored on a disk. These 
other files may themselves be directories CcalEcd 
subdirectories), A directory is sometimes called a 
catalog. 

disassembler: A language translator that 
converts a machine-language program into an 
equivalent program in assembly language, which 
is easier for programmers to understand. The 
opposite of an assembler, 

disk-based: See disk- resident- 
disk controller card: A peripheral card that 
provides the connection between one or two disk 
drives and the computer. (This connection, or 
interface, is built into the Apple lie, the 
Apple lies, and all Macintosh-family computers,) 

disk operating system; An operating system 

whose principal function is to manage files and 
communications with one or more disk drives. 
DOS and FroDOS are two disk operating systems 
for the Apple II. 

disk- resident: A program that does not remain in 
memory. The computer retrieves all or part of the 

program from the dish h as needed. Sometimes 
called disk-based. Compare memory-resident. 
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Disk U drive: An older type of disk drive made 

and sold by Apple Computer for use with i±ie 
Apple II, II Phjs, and lie. It uses 525-inch floppy 
disks. 

display: (1) A genera] Term to describe what you 
sec on the screen of your display device when 
you're using a computer. (2) Short for a display 

device. 

display devices A device that displays 

information, such as a television set or video 
monitor. 

dithering: A technique for alternating the values 
of adjacent pixels to create the effect of 
intermediate values. Dithering can give the c fleet 
of shades of gray on a black-and-white display, or 
more colors on a color display. 

DOO Sec Distal Oscillator Chip, 

DOS; See disk operating system, 

DOS 3^3; An operating system for the Apple tl 
family of computers DOS stands for Disk 
Operating System; 3,3 is the version number. 

D£K: See Data. Set Ready. 

DTE; See Data Terminal Equipment. 

DTRi See Data Terminal Ready. 

dual In-line package: A type of integrated circuit 
package that is rectangular and has a row of 
connector pins along each side 

Dvorak keyboard; An alternate keyboard Layout, 

also known as the American Simplified Keyboard, 
which increases typing speed because the keys 
most often used are in the positions easiest to 
reach. Compare QWERTY keyboard. 

edit* To change or modify. For example, to 

insert, remove, replace, or move text in a 
document. 

editor; A program that helps you create and edit 
information of a particular form- for example, a 
text editor or a graphics editor. 



effective address: In machine- language 
programming, the address of the memory 
location on which a particular instruction 
operates, which may be arrived at by indexed 
addressing or some other addressing method. 

« flag; One of three (lag birs in the 65C8I6 
processor that programs use to control the 
processor's operating modes. The setting irf [he e 
flag determines whether the processor is in native 
mode or emulation mode, See also m flag, x flag, 

B-bJt Apple II: Another way of saying standard 

Apple II p that is, any Apple I! with an 8-bit 
microprocessor (65*32 or 65C02) 

»0 column text card; A peripheral card that 

allows the Apple II, Apple II Plus, and Apple He to 
display text in BO columns (in addition to the 
standard 40 columns). 

emulate; To operate in a way identical to a 
different system. For example, the 6$CBl6 
microprocessor in the Apple IIG5 can carry Dtit all 
[he instructions in a program originally w r ritten for 
an Apple 11 that uses a 6502 microprocessor, thus 
emulating the 6502. 

emulation mode: A manner of operating in 
which one system imitates another, in ihc 
Apple lies computer, the mode the 65CS16 Is in 
when the Apple IIGS is running programs written 
for Apple II'j that use the 6^02. 

Escape character; An ASCII character thai, with 
many progr-nrn.-, and devices, allows you to 
perform special functions when used in 
combination keypresses. 

Escape key; A key on Apple ll-family computers 
that generates the Escape character. The Escape 
key is Labeled Esc. In many applications, pressing 
F-^^ipc allows you to return to a previous menu or 
to stop a procedure. 
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even parity; In data transmission, the use of an 
extra bit set 10 or 1 as necessary to make the total 
number of I bits an even number; used as a means 
of error cheeking. Compare MARK parity, odd 
parity, 

event-driven: A kind of program that responds to 

user inputs in real time by repeatedly testing for 
events posted by interrupt routines. An event- 
driven program docs nothing until it detects an 
event such as a click of the mouse button. 

expansion slou A socket into which you can 

install a peripheral card. Sometimes called a 
peripheral .slot. See also auxiliary slot. 

Extended HO-Column Text Card; See 
Apple lie Extended ftO-CoIumn Text Card 

file type: in a directory listing, the code that 
characterises the contents of a file and indicates 

how the file may be used. 

firmware: Programs stored permanently in read- 
only memory (ROM) Such programs (for 
example, the Applesoft Interpreter and the 
Monitor program) are built into the computer at 

the factory. They can be executed at any time but 
cannot be modified or erased from main 

memory. 

fonts In typography, a complete set of type in one 
size and style of character. In computer usage, a 

collection of letters, numbers, punctuation marks, 
and other typographical symbols wiLh a consistent 
appearance. 

for mat; (n) The form in which information is 
organized or presented- (v) To divide a disk into 
tracks and sectors where information can be 
stored. Blank disks must be formatted before you 
can save information on them for the first time^ 
same as initialize. 

frequency: The rate at which a repetitive event 
recurs, In alternating current (AC) signals* the 
number of cycles per second. Frequency is usually 
expressed in hertz (cycles per second), 
kilo hertz, or megahertz. 



function* A programmed sequence of operations 

that can be carried out on request from any point 
in a program. A function lakes one or more 
arguments and returns a single value. It can 
therefore be embedded in an expression. 

game I/O connector: A 16- pin connector inside 

all the open models vf the Apple 11, originally 
designed for connecting hand controls to the 
computer, but also used for connecting some 
other peripheral devices. Compare hand control 
connector, 

GLU; Acronym for general logic unit, a dass of 
custom integrated circuits used as interfaces 
between different parts of the computer. 

graph* A pictorial representation of data. 

graphics* (1) Information presented in the form 
of pictures or images. (2) The display of pictures 
or images on a computer's display screen. 
Compare text. 

hand controls* Peripheral devices, with rotating 
dials and push buttons. I land controls are used to 
control game- playing programs, but they can also 
be used in other applications. 

hand control connector* A 9-pin connector on 

the back panel of the Apple lie, Apple Re, and 
Apple IIGS computers, used for connecting hand 
controls to the computer. Compare game I/O 
connector. 

handshaking; The exchange of status 
information between a DCE and a DTE used to 
control the transfer of data between them, The 

status information c^n be the state of a signal 
connecting the DCE and the DTE, or It can be in 
the form of a character transmitted with the rest of 
the data. See also XON and XOFF, 

hertz: The unit of frequency of vibration or 
oscillation, defined as the number of cycles per 
second- Named for the physicist Heinrich Herte 
and abbreviated Hz See also kilohertz, 
megahertz. 
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LiexadcclmaL The base- 1*5 system of numbers, 
using the ten digits through 9 and the six [tilers A 
through F. Hexadecimal numbers can be 
convened easily and directly lo binary form, 
because each hexadecimal digit corresponds to a 
sequence of four bits. Hexadecimal numbers are 
usually preceded by a dollar sign (5), 

high-level language: A program niing language 
that is relatively easy for people Lo understand. A 
singJe statement in a high-level language typically 
corresponds to several instructions of machine 
language. Compare low-level Language, 

high-order byte; 1T»c more significant half of a 

memory address or other mulu%byte quantity. In 
the 6502 microprocessor used in Lhe Apple II 
family of computers, Lhe low-order byte of an 
address is usually stored first, and the high-order 
byte second. (In the 68000 microprocessojs used 
in the Macintosh family, the high-order byte is 
stored first.) 

Ill Res: A high- resolution display mode on Lhe 
Apple II family of computers, consisting of an 
array of points, 280 wide by 192 high, with 6 
colors. 

Hz: See hertz. 

12BK Apple H: Any standard Apple 11 with both 
main and auxiliary 64K banks of RAM. That 
includes all models of Lhe Apple Itc and some 
models of Lhe Apple lie, inducting those with the 
Extended SOColumn Text Card installed The 
Apple I1GS is not a 126K Apple D in the Strict 
sens^ even though It includes both 64K banks of 
RAM and Is capable of running programs designed 
for a 128K Apple 11 

IO Sec integrated circuit. 

loon: An image that graphically represents an 

object, a concept, or a message, 

implement To put into practical effect, as to 
implement a plan. For example h a language 
translator implements a particular language, 



Index register: A register in a computer 
processor that holds an index for use in indexed 
addressing. The 6502 and 65C816 
microprocessors used In the Apple II family of 
computers have two index registers, called the 
X register and the Y register. 

Indexed addressing: A method used in 

machine-language programming Lo .specify 
memory addresses. See also memory location. 

input: (n) Information transferred into a 

computer from some external source, such as the 

keyboard, a disk drive, or a modem. 

Input/output (I/O): The process by which 
information is transferred between the computer's 
memory and its keyboard or peripheral devices. 

Instruction; A unit of a machine-language or 
assembly-language program corresponding to a 
single action for the computer's processor to 
perform. 

Integrated circuit; An electronic circuit, 

including components and interconnections, 
entirely contained in a single piece of 
semiconducting mate rial, usually silicon. Often 
referred Lo as an /Cor a chip. 

Interactive: Operating by means of a dialog 
bcLween tl>e computer system and a human user. 

interface* CO The point at which independent 
Systems or diverse groups interact The devices, 
rules, or conventions by which one component of 
a system communicates with another. Also, the 
point of communication between a person and a 
computer. (2) lhe part of a program that defines 
constant, variables, da La structures, and 
procedure-calling conventions h rather than 
procedures themselves 

interface card; A peripheral card that 

implements a particular interface (such as a 
parallel or serial interface) by which the computer 
can communicate with a peripheral device such as 
a printer or modem. 
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Interrupt: A temporary suspension in the 
execution of % program that allows the computer to 
perform some other task, Lypically in response to a 
signal from a peripheral device or other source 
external to the computer. 

I/Os Sec tn put/11 ut put 

I/O device: Input/output device, A device that 
transfers information. Into or out of a computer 

I/O link: A fixed location that contains the 
address of an inpuLfoutput subroutine in the 

computer's Monitor program, 

IWM: Abbreviation for Integrated Woz Machine, 
the custom chip used in built-in disk ports on 

Apple computers. 

joystick; A peripheral device with a Vcver< 

typically used to move creatures and objects in 
game programs^ a joystick can also used In 
applications such as computer-aided design and 
graphics programs. 

Kj See kilobyte, 

keyboard ' rne ^ of keys, similar to a typewriter 
keyboard, used for entering information into the 

computer. 

kilobit: A unit of measurement, 1024 bits, 

Lornmonly u.^'ilL in Sjiecifyinfl [he capacity of 
memory ICs. Not Lo be confused with kilobyte* 

kilobyte (K); A unit of measuremenL of computer 
data or memory, consisting of 1024 (2*^) bytes, 
When used this way, jfei/oCfrom the Crock, 
meaning a thousand) stands for 1024. Thus, 64K 
memory equals 65.536 bytes. See also megabyte. 

kilohertz: A unit of measurement of frequency, 
equal to 10GO hertz (abbreviated fcHfcX See also 
megahertz. 

KSWt The symbolic name of the location in the 
computer's memory where the standard input link 
(nan*ely p Lo the keyboard) is stored KSVF stands 

for keyboard switch. 

language: See programming language. 



language card: A peripheral card that, when 

ia^talled in slot of a 4&K Apple El or 
Apple II Plus, gives the computer a total of 6<iK of 
memory. In Apple H's with 64K or mora of 
memory, trie part of memory equivalent to that 
occupied by a language card is sometimes called 
language-card memory, 

line length: The number of characters that fit in a 
line on the screen or on a page. 

load: To transfer information from a peripheral 

storage medium (such as a disk} into main 
memory for use — for example, to ir.inM^s a 
program into memory for execution. 

loader; A program that brings flics from a disk 
into the computer's memory. 

location; See memory location. 

logic board: See main logic board. 

loop: A section of a program that is executed 
repeatedly until a limit or condidon is met, such as 
an index variable's reaching a specified ending 
value, kec loop. 

low- level language: A programming language 
that is relatively close to the form the computer's 
processor can execute directly. One statement in a 
low -level language corresponds to a single 
machine-language instruction. Compare high- 
level language* 

low order bytes The least significant byte of a 
memory address or other multi-byte quandty. In 
the 6502 and 65C3NS microprocessors used in the 
Apple II family of computers, the low-order I 
of an address is usually stored fin>t r and the high- 
order byte last On the 68000 microprocessors 
used in the Macintosh family, the high-order byte 
is stored first ) 

Lo-He£: The lowest-resolution graphics mode on 

the Apple II family of computers, consisting of an 
array of blocks 48 high by 40 wide with 16 colors. 
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machine language: The form in which 
instructions to -a computer are stored in memory 
for direct execution by the computer's processor. 
Each model of computer processor (such as the 
6502 microprocessor used in 6-bit Apple II 
computers) has its own form of machine language, 

Macintosh; A family f Apple computers built 
around 68000 microprocessors, having high- 
resolution black-and-white displays and using 
mouse devices for choosing commands and for 
drawing pictures. 

macro: A single predefined assembly-language 
pseudo-instruction that an assembler replaces with 
several actual instructions, Macros arc almost like 
higher-level instructions that can be used inside 
assembly-language programs, making the 
programs easier to write. 

macro assembkn A type of assembler thai 
allows the programmer to define Sequences of 
several assembly language instructions as single 

pseudo- instructions called macros. 

main logic board; A large circuit board that holds 

RAM, ROM, the microprocessor, custom 
integrated circuits, and other components that 
make the computer a computer. 

main memory: The part of a computer's 

memory whose contents are directly accessible to 
the microprocessor; usually synonymous with 
random-access memory (RAM), 

MARK parity: A hit of value 1 appended to a 
binary number for transmission. The receiving 
device checks for errors by looking for this value 
on each character. Compare even parfty t odd 
parity, 

Mega Hi A custom large-scale integrated circuit 
that incorporates most of the timing and control 
circuits of the standard Apple IT. ft addresses 128K 
of RAM organized as MK main and auxiliary banks 
and provides the standard Apple II video display 
modes, both text (40-cotumn and 80-cohimn) and 
graphics CLo-Res. Hi-Res, and Double Hi- Res). 



megabit A unit of measurement, 1,048,576 (2^ 
bits or 1024 kilobits* commonly used in 
specifying the capacity 1 of memory ICs, Not to be 
confused with megabyte- 
megabyte: A unii of measurement of computer 
data or memory, equal to l,0m,5l6 bytes or 
1024 kilobytes; abbreviated Mb. 

megahertz* A unit of measurement of 
frequency, equal to 1,000,000 hertz 

(abbreviated MHz). Sec also kllohcrtz. 

memory: The hardware component of a 
computer system thai stores information for later 
retrieval. See also main memory, random- 
access memory, read-only memory, read- 
write memory. 

memory location: A unit of main memory that is 
identified by an address and can hold a single item 
of information of a fixed size. In the Apple II 
family of computers, a memory location hold* 
one byte- 
Memory Managen One of the programs in the 
Apple IIGs Toolbox. lis job is to allocate memory' 
so that applications and desk accessories can run 
without clobbering each other. 

memory-mapped I/Qj The method used for I/O 

ope radons in Apple II computers, where certain 
memory locations are attached to I/O devices, 
and I/O operations are just memory load and 
stoic instructions, 

memory resident! Cadj) CD Stored permanently 
in memory as firmware CKOM), (2) Held 
continually in RAM even while not in use. DOS is a 
memory-resident program. Compare dlsk^ 
resident, 

menu: A list of choices presented by ■ program, 
from which you <.an select art action. See also 
desktop environment. 

menu ban The horizontal strip at the top of the 
screen that contains menu titles. 
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menu titles A word, phrase, or Icon in the menu 
bar that designates one menu. Pressing on the 
menu tide causes the title to be highlighted and its 
menu to appear below iL 

m flag: One of three flag bits in the 65CS16 
processor that programs use to control the 
processor's operating modes. In native mode, the 
setting of the m flag determines whether the 
accumulator is S-btts wide or 16-bits wide. See also 
eflag^xflag, 

MHz: Abbreviation for megahertz, one million 
henz. See hern, 

microprocessor: A computer processor 
contained in a single integrated circuit. The 
microprocessor is the central processing unit 
(CPU) of the microcomputer. Examples Include 
the 6502 and 65CB16 microprocessors used in the 
Apple II family of computers and the 68000 
microprocessor used in the Macintosh family. 

microseconds One millionth of a second- 
Abbreviated JiS. 

millisecond; One thousandth of a second. 
Abbreviated mi. 



s A state of a computer or system that 
determines its behavior. A manner of operating. 

modem: Short for MOduIator/DEModuIator, A 
peripheral device that links a computer to other 
computers and information services using the 
telephone lines. 

monitor: Sec video monitor. 

Monitor program: A system program built into 
the firmware of Apple II computers, used for 
directly Inspecting or changing the contents of 
main memory and for operating the computer at 
the machine-language level. 

MOSs Abbreviation for metal oxide silicon, a 
method of semiconductor integrate d-circu it 

fabrication on silicon using layers of silicon 
dioxide in the make-up of the devices. Compare 
CMOS. 



mouse; A small device you move around on a Hat 

surface next to your computer. The mouse 
controls a pointer on the screen whose 
movements correspond to those of the mouse. 
You use the pointer to select operations, to move 
data, and to draw with in graphics programs. 

mouse button: The button on the top of the 
mouse. In general, pressing the mouse button 
initiates some action on whatever is under the 
pointer, and releasing the button confirms the 
action. 

NTSG (1) Abbreviation for National Television 
Standards Committee, The committee that 
defined the standard format used for transmitting 
broadcast video signals in the United States. 
Q) The standard video format defined by The 
NTSC, also called composite^ because it 
combines all the video information, including 
color, into a single signal 

object code: 5ee object program. 

object program; The translated form of a 
program produced by a language translator such 
as a compiler or assembler, Also called object 
code. Compare source program. 

Odd parity? In data transmission, the use of an 
extra bit set to or 1 as necessary to make tfie total 
number of I bits an odd number^ used A$ a means 
of error checking. Compare even parity, MARK 
parity. 

12BK Apple II: Any standard Apple II with both 
main and auxiliary 64K banks of RAM. That 
includes all models of the Apple He and some 
models of the Apple He, including those with the 
Extended 80-Column Tent Card installed. The 
Apple IIG5 is not a I28K Apple II in the Strict 
sense, even though it includes both 64K banks of 
RAM and is capable of running programs designed 
for a 128K Apple II. 

opcode: See operation code. 
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Open Apple key; A modifier key on some 
Apple IJ-family keyboards- on ihe Apple IIGS 
keyboard, the equivalent key is marked with both 
an Apple Icon and a spinner, the icon used on 
some Macintosh keyboards, and called simply the 
Apple key. 

operation codes The machine-language 
representation of a computer instruction. 

operating system: A general-purpose program 
thai manages the actions of the parts of the 
computer and its peripheral devices for the benefit 
of the application programs. See disk operating 
system. 

overrun: A condition that occurs when the 
processor does not retrieve a received character 
from the receive data register of a 

communications interface device before the 
subsequent character arrives to occupy thai 
register. 

page: £1} A segment of main memory 256 bytes 
long and beginning at an address that is an even 
multiple of 256. (2) An area of main memory 
containing text or graphical information being 
displayed on the screen Page is usually 
capitalized when it has this meaning, 

page zero: See zero page. 

parallel Interface: An Interface in which several 
bits of information (typically 8 bits, or 1 byte) arc 
transmitted simultaneously over different wires or 
channels, Compare serial interface. 

parameter; An argument that determines the 
outcome of a command- Por example, in ihe 
command writeCn t msg) r wand msg are 

parameters. 

parity: Sameness of level or count, usually the 
count of 1 bits in each character, used for error 
checking in data transmission. See even parity, 
MARK parity, odd parity, parity blL 



parity bit: A bit used to check for errors during 
data transmission. Depending on the number of 1 
bits in a transmission, the parity bit is set to 1 or 
to make the total number of 1 bits even or odd. 

FascaL A high-level programming language with 
statements that resemble English phrases, Pascal 

was designed to teach programming as a 
systematic approach to problem solving. Named 
after the philosopher and mathematician TSlaise 
Pascal, 

peripheral? (adp At or outside the boundaries of 
the computer itself, either physically (as a 
peripheral device) or in a logical sense Cas a 

peripheral card). <n> Short for peripheral deul€£. 

peripheral card: A removable prinicd-circuit 
board that plugs into one of the computer's 
expansion slots. Peripheral cards enable the 
computer to use peripheral devices or to perform 
other subsidiary or peripheral functions, 

peripheral device: A piece of hardware — such as 
a video monitor disk drive, printer, or 
modem — -used in conjunction with a computer 
and under the computer's control. Peripheral 
devices are often (but not necessarily) physically 
separate from the computer and connected to it by 
wires, cables, or some other form of interface. 
They often require peripheral cards, 

peripheral slot: See expansion slot. 

phase: 0) A stage in a periodic process. A point 
in a cycle. For example, the 65CSl(n 
microprocessor uses a clock cycle consisting of 
two phases called *0 and <D1. (2} The relationship 
between two periodic signals or processes. 
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pixel; Short for picture element The smallest dot 
you can draw on the screen. Also, a location in 
video memory that corresponds to a point on the 
graphics screen when the viewing window includes 
that location. In the Macintosh display F each pixel 
can be either black or white, so it can be 
represented by a bit; thus, the display is said to be 
.i, bitmap, fn rhi- Sopea ] N-ftc-s display on ilk- 
Apple Ugs, each pixel is represented by either two 
ur four bits; the display is not a bitmap, but rather 
a pixelmap. 

pLxelmap: A set of values that represents the 
positions and stales of ihe set of pixels making up 
an image. Compare bitmap. 

pop: To retrieve an entry from the top of a stack, 

moving the stack pointer to point to the previous 
entry, Compare push- 
ports A socket on the back panel of the computer 
where you can plug in a cable to connect a 
peripheral deviu; another computer, or a 
network. 

PR/; An Applesoft BASIC command that directs 
output to a slot or a machine-language program h 
activates an output routine in the ROM on a 
peripheral card or in equivalent RAM by changing 
the address of the standard output routine used by 
the computer. 

procedures In the Pascal and Logo programming 
languages, a sequence of instructions that work as a 
unit!, approximately equivalent to the term 
function in C or subroutine in BASIC. 

processors The hardware component of a 
computer that performs the actual computation by 
directly executing instructions represented in 
machine language and stored in main memory. 
See microprocessor, 

ProDOS: A disk operating system for the 

Apple II family of computer. ProDOS stands for 
frofessional Disk Operating System, and includes 
ProDOS 8 and ProDOS 16, 



ProDOS Bt A disk operating system for the 
Apple Nit runs on 6502 and 65C02 
microprocessors and on the 65CS16 in $502 
emulation mode. 

ProDOS 16: The disk operating system 

designed for the Apple lies, ProDOS In is similar 
to ProDOS B p but was designed to run on the 
65C816 microprocessor in the Apple IIGS. 

program: 00 A sequence of instructions 
describing actions for a computer to perform in 
order to accomplish some task, conforming to the 
rules and conventions of a particular 
programming language. (V) To write a program. 

programmable read-only memory (PROM): A 

type of ROM device that is programmed after 
fabrication, unlike ordinary ROM devices, which 
are programmed during fabrication. 

programming language: A set of symbols and 
associated rules or conventions for writing 
programs. BASIC, Logo, and Pascal are 
programming languages. 

PROM: See programmable read-only 
memory, 

prompt A message on the screen that tells you of 
some need for response or action. A prompt 

usually lakes the form of a symbol, a message, a 
dialog box, or a menu of choices. 

prompt character; A text character displayed on 
the screen, usually just to the left of a cursor, 
where your next action Is expected- The prompt 
character often identifies the program or 
component of the system that's prompting you. 
For example, Applesoft BASIC uses a square 
bracket prompt character CD, the system Monitor 
program, an asterisk C*5; and the Mini-assembler, 
an exclamation point (0. 

protocol: A formal set of niles for the interchange 
of information between two programs or devices! 
for example,, the rules for sending and receiving 
data on a communication line. 
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Protocol Converter; A set of ROM-based 

assembly-language routines used to support 
external I/O devices such as the Appier Memory 
Expansion Card and the Apple 3.5 Drive. 

push To add an entry to the lop of a stack, 
moving the Slack pointer to point to it Compare 
pop. 

queue: A list in which entries are added at one end 

and removed at The other, causing entries to be 
removed in first-in, firstoui (FIFO) order. 
Compare stack. 

QWERTY keyboard: The Standard layout of keys 
on a typewriter keyboard; its name is formed from 
the first six letters on the top row of letter keys. 
Compare Dvorak keyboard, 

RAM: See random-access memory, 

RAM disk: A feature of some operating systems 

which makes it possible to use programmable 
memory (RAM) as a disk volume. Large 
applications designed for machines with Limited 
amounts of RAM must load program segments 
from disk as needed: on machines with HAM disk, 
the entire application is first loaded into RAM, 
where it runs as if still resident on disk, but much 
faster. 

random- access memory (RAM); Memory in 

which information cars be referred to in an 
arbitrary or random order. As commonly used. 
RAM means the pan of memory available for 
programs from a disk; the programs and other 
data are lost when the computer is turned oJT, 
(Technically, the read-only memory (ROM) is 
atso random access, and what's called RAM 
should correctly be termed read- write memory.} 
Compare read-only memory, read-write 
memory, 



read-only memory (ROM): Memory whose 
contents can be read, but not changed; used for 
Storing firmware. Information is placed into 
read-only memory nno£ Y during manufacture; ft 
then remains there permanently, even when the 
computer's power is turned off. Compare 
random-access memory, read- write 
memory, write-only memory. 

read' write memory: Memory whose contents 
can be both read and changed Cor written to); 
commonly called RAM. The information 
contained in read- write memory is erased when 
the computer's power is turned off and is 
permanently iost unless it has been saved on a disk 
or other storage device. Compare random- 
access memory, read-only memory- 

reentrant: Characteristic of a program routine 

that is able to accept a call ■while one or more 
previous calls to it are pending without 
invalidating any previous calls. 

register: A location m a processor or other 

device where an item of information is held and 
modified under program control. 

R«wree Manager; A Macintosh tool for editing 
data in program segments without recompiling 

them. 

resident: See memory- resident, dfsk- 
resident. 

return address: The point in a program to which 
control returns on completion of a subroutine or 
function. 

RGB: Abbreviation for red-green -blue, a method 
of displaying color video by transmitting the three 

primary colors as three separate signals. There are 
two ways of using RGB with computers; TTL RGB. 
which allows the color signals to take on only a few 
dLscreie values; and analog RGB* which allows tfie 
color signals TO lake on any values between their 
upper and lower limits, for a wide range of colors. 
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RGB monitor. A type of color monitor that 
receives separate signals for each color (red, 
green, and blue). Compare composite video. 

ROM: See read-only memory. 

ROM disk: A feature of some operating systems 
making it possible 10 use read-only memory 
CftOM} as a disk volume. Often used for making 
applications permanently resident. Sec also RAM 
disk. 

routine: A pan of a program that accomplishes 
some task subordinate to the overall task of the 
program, 

row: A horizontal line of character ceils or 
graphics pbrels on the screen. 

RS-232; A common standard for serial data- 
communication Interfaces, 

KS-422: A standard for serial data- 
communication interfaces, different from the 
R5-232 standard in its electrical characteristics and 
in its use of differentia! pairs for data signals. The 
serial ports on the Apple lies use RS-422 devices 
modified so as to be compatible with RS'232 
devices. 

SANE: See Standard Apple Numeric 
I my iron me nt< 

SCO See Serial Communications Controller. 

screen holes: Locations in the lexl display buffer 
(text Page I) used for temporary storage either by 
I/O routines running in peripheral -card ROM or 
by firmware routines addressed as if they were in 
card ROM. Text ^agc 1 occupies memory from 
SCtfOO to SOTFF* the screen holes are locations in 
that area that are neither displayed nor modified 
by the display firmware. 

Serial Communications Controller (SCC): A 

type of communications 1C used in the Apple 11GS 
computer. Compare ACFA, 



serial Interface: An interface in which 
information is transmitted sequentially, a bit at a 
time. Over a single wire or channel. Compare 
parallel Interface. 

serial port: The connector for a peripheral device 
that uses a serial Interface* 

silicon: A solid, crystalline chemical element 
(symbol Si) from which integrated circuits are 
made. Silicon Ls a semiconductor; that is, it 
conducts electricity better than insulators, but not 
as well as metallic conductors, Silicon should not 
be confused with silica — that is, silicon dioxide, 
such as quarts opal, or sand — or with silicone, 
any of a groop of organic compounds containing 
silicon. 

Simplified Keyboard: See Dvorak keyboard 

(.vi K Apple U: Any standard Apple II that has at 
least 64K of RAM That includes the Apple tic. the 
Apple Uc K and an Apple II or Apple II Plus with 
4m of RAM and the Apple Language Card 
installed, 

6502: The microprocessor used in the Apple n, in 
the Apple II Plus, and in early models of the 
Apple He. The 6502 Ls an MOS device with 8-bit 
data registers and 1 6-bit address registers. 

65CQ2: A CMOS version or the 6502- the 
microprocessor used in the Apple He and in the 
enhanced Apple He. 

65C816: The microprocessor used in the 
Apple I1C5. The 65CB16 is a CMOS device with 
16-bit data registers and 24-bit address registers. 

63000: The microprocessor used in the 
Macintosh and Macintosh Plus. The 68000 has 
32-bit data and address registers. 

slot: A narrow socket inside the computer where 

you can install peripheral cards, Also called an 
expansion, slot. 

soft switch: A location in memory that produces 
some specific effect whenever its contents are read 

or writii'ii 
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software: A collective term for programs, the 

instructions thai tell the computer what lo do. 
They're usually stored on disks. Compare 
firmware. 

source code: See source program* 

source program: The form of a program given to 
a language translator, such as a compiler or 
assembler, for conversion into another form; 
sometimes called sott rce code, Compare object 
program. 

stack: A list in which entries an: added (pushed) 
or removed (popped) at one end nnly (the lop of 
the stack), causing them to be removed in last In, 
first-out (LIFQ) Order. Compare queue. 

standard Apple 11: Any computer in the Apple 11 
family except the Apple EICS. That Includes the 
Apple II, the Apple 19 Plus r the Apple lie, and the 
Apple He. 

Standard Apple Numerics Environment 
(SANE): Apple's implements iou nf 1L-EE standard 
floating-point arithmetic, used on the Apple II 
and Macintosh families of computers. 

start hit: One or two bits that indicate the 
beginning of a character in a string of serially 
transmitted characters. 

start vpi To get the system running. Starting up is 
the process of first reading the operating system 

program from the disk, and then running an 
application program, Starting up is often called 
booting* 

startup disk: A disk with all ihe necessary 
program files to set the computer into operation. 
Sometimes called a boot disk, 

stop bit: A bit indicating the end of a character in 
a string of serially transmitted characters. 

strobe: A signat whose change rs used to trigger 
some action. 

subdirectory* A directory within a directory, A 

file conjoining the names and locations of other 
files. 



subroutine: A part of a program that can be 
executed on request from another point in the 

program and thar h on completion, returns control 
to that point. 

synchronous: A mode of data transmission in 
which a constant lime interval exists between 

transmission of successive bits, characters, or 
events Compare asynchronous, 

system: A coordinated collection of interrelated 
and interacting parts organized to perform some 

function or achieve some purpose — for example, 

a computer system comprising a processor, 
keyboard, monitor, and disk drive. 

system configuration t See configuration. 

system program: A program that makes the 
resources and capabilities of the computer 
available for general purposes, such as an 
operating system or a language translator. 
Compare application program, 

system software: The component of a computer 
system that supports application programs by 
managing system resources such as memory and 

I/O devices. 

text: (1) [nforntltfofi presented in the form of 
readable characters. (2) The display of characters 
on a display screen. Compare graphics. 

leKt window: A window on the ctesktnp within 

wliu h text is displayed and scrolled. 

toolbox: A collection nf built-in routines that 
programs can call to perform many commonly 
needed functions. 

trans Istor-translsmr logic (TTL): (1) A family 
of integrated circuits having bipolar circuit logic; 
TTL ICs arc used in computers and related devices. 
C2) A standard for interconnecting such circuits, 
which defines the voltages used to represent 
lugicai zeros and ones. 

TTIj See transistor- trans is tor logic 
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TTL RGB? A type of iddeo monitor that can accept 
only a limited number of digital values and display 
only a correspondingly limited number of colors. 
Compare analog RGB, 

type-ahead bulTert A buffer that accepts and 

holds characters that are typed faster than the 
computer can process them. 

user; A person operating or controlling a 
computer system. 

user Interface: The rules and conventions by 
which a computer system communicates with the 
person operating it, 

utilities; Programs that let you rename, copy, 
format, delete, and otherwise manipulate Files and 
volumes- 

value: An item of information that can be stored 
in a variable, such as a number or a string. 

variable: G3 A location in the computer's 
memory where a value can be stored. <2) The 
symbol used in a program to represent such a 
location. 

VBL: Short for vertical blanking, an interrupt 
signal generated by the video timing circuit each 
time it finishes a vertical scan, 60 times a second. 

vector: (1) The starting address of a program 
segment when used as a common point for 

transferring control from other programs. C2) A 
memory location used to hold a vector, or the 

idling ■■'] .sin h ,i l'X-.Uir.>n 

vjdtOi CD A medium for transmitting information 
in the Form of images to be displayed on the 
screen of a cathode-ray tube, (2) Information 
organised or transmitted in video form. 

video monitor? A display device that can Tecmiv^ 
video signals by direct connection only, and that 
cannot receive broadcast signals such as 
commercial television. Can be connected directly 
to the computer as a display device. 



warm start: The process of transferring control 
back to the operating system in response to a 

failure in an application program. Compare cold 
start. 

window: The area that displays information on a 
desktop. You view a document through a window. 
You can open or dose a window, move it around 

on the desktop, and sometimes change its .si^e, 
scroll through it, and edit its contents. 

word: A group of bits that is treated as a unit The 
number of biLs in a word is a characteristic of each 
particular computer, in the Apple ilGS, words are 
sixteen hits wide, 

wraparound: The automatic continuation of text 
from the end of one line to the beginning of the 
next- wraparound means that you don't have to 

press the Return key at the end of each line as you 
type. 

write-only memory: A form of computer 
memory into which information can be stored but 
never, ever retrieved. For more information, refer 
to The Life o/Homberg T, Ramsf&rfe by Bruce, 

Tognair-fcEni, 

x flag: One of three flag bits in the 65C316 
processor that programs use to contrnl the 
processors operating modes. In native mode, the 
setting of tike x flag determines whether the index 
registers arc 8-bits wide or lo-biis wide. See c flag, 
in flag, 

XON; A special character (ASCII value $13) used 
for controlling ihe transfer of data between a DTE 
and a DCE See handshaking, XOFS% 

XOFF; A special character (ASCtI value Sll) used 

for controlling the transfer of data between a DTE 
and a DCE, When one piece of equipment receives 
an XOFP character from the other, it stops 
transmitting characters undl tt receives an XON. 
See handshaking, XON* 

X register: One of the two indctf registers in the 

65C616 and 6502 microprocessors. 
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Y negisten One of the two index registers in the 

65CB16 and 6502 microprocessors. 

zero pages The first page (256 bytes} of memory 
in the Apple I] family of computers, afso called 
page zero. Since the high-order byte of any 
address in this page is zero, only the low-order 
byte ts needed 10 specify a 2ero-pagc address; thts 
makes zero-page locations more efficient uj 
address, in both umc and space, than locations in 
any other page of memory. The 65CB16 
microprocessor used in the AppEe ElOS has a 
relocatable aero page called the direct page* 
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way they are used by different types of programs 

* ft explains die basic desftn of the Apple llu\ \vii3i :jihhilHix j irfrtx* 
machined arcliiieaure and a description < >f its menu in 7 features. 

* It introduces the Toolbox, a set uf built-in program tools thai support 
the desktop user envuxjnment and make it easier ft )r application 
programs to take advantage of the machine's new leaning, 

* ft discusses fesues of particular interest u » developers, .such as prcigrani 
compatibility with other computers in the Apple 11 family 

* It introduces the Apple lies hsjgrammers^i jrtehup, which is a complete 

development system tliat iiuiude* an editor, C compiler, and linker 

Whether scute an experienced developer for ocher Apple computers 

or a newcomer, this book provides an entry uui i the technical side d 
the Apple Q<& It is ran a highly tedinfcal book, hut you should already 
be familiar with the general principles of pew mal computers and hive 
sc Hne knowletfee of pn jgramming, 

hi addition toaglossary of leohnk i\ ktiik hxhiiuiUntnxkiCtmito 
the Apple /fcs includes the appendix Unadmap 10 tile Apple lk;s 
Technical Manuals," which describes the other technical manuals in tiie 
Apple Dcs Suite and helps you decide which ones you need. 
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